Loppee Personal

Submits the signed-in customer's application to one active job: the job, a cover note and the resume the customer attached (PDF, DOC or DOCX, up to 5 MB). The resume is a file parameter: ChatGPT supplies the attached file's download URL and file id, and Loppee downloads the original file. Loppee shares the application with the employer. The resume is held in quarantine until a malware scan passes, and the result reports scanning, failed or submitted. Applying is free. Requires the connection's permission to manage job applications.

apply_to_job

Returns the status of a location request created by create_location_handoff: awaiting_user, ready, declined, expired or revoked, with its expiry and next_action. wait_for_iphone_location means the iPhone is still completing the request; open_loppee_phone_app means it is waiting for the customer in the Loppee iPhone app under Account, My AI agents, Pending location requests; search_with_location_handoff means it is ready to use as location_handoff_id in search_businesses; create_new_location_handoff means it has ended. It returns status only, never a location, and does not change the request.

get_location_handoff

Compares two to twenty Loppee business ids side by side using public facts, in the order given. Published businesses keep their Verified or Listed class; Registry records keep their claim status and disclosure. Ids that are unknown, private or unavailable are reported as unresolved. Payment does not affect the comparison.

compare_businesses

Creates a request for the current location of the customer's registered Loppee iPhone, for one nearby search in the service category q (for example HVAC or plumbing). Requires the Loppee Personal OAuth connection. The request is delivered to the Loppee iPhone app. If the customer has allowed this connection automatically and the category is recognized, the iPhone completes it without a prompt (request_mode=automatic); otherwise the customer approves or declines it in the app (request_mode=approval_required). The response contains the request id (handoff_id), status, expiry, poll_after_seconds and next_action: poll_location_handoff while the iPhone completes the request, or open_loppee_phone_app when it is waiting in the app under Account, My AI agents, Pending location requests. The response never contains a location. A connection has one active request at a time; while one is active, this returns location_handoff_pending with that request's id. Requests expire on a server-side timer: about 10 minutes to be approved and up to 15 minutes of use after approval, after which Loppee deletes the encrypted location.

create_location_handoff

Explains one published business's standing: its Verified or Listed class and disclosure, its review-reputation band from interaction-backed reviews, its recommendation order and its commercial reach. Private reviewer weighting is not included.

explain_recommendation

Returns what the Loppee Personal connection can do: the available tools and the permission each one needs. It covers the consumer connection only; business-owner and administrator access are not part of Loppee Personal.

get_agent_capabilities

Returns the signed-in customer's Loppee Personal connection: account label, sign-in method and the permissions granted to this connection, such as messaging businesses, publishing reviews and managing job applications. It reads permissions only and does not sign in or change them.

get_agent_identity

Returns a business's public reviews, paginated like its profile page and optionally filtered by star rating. A review is labelled Verified interaction when Loppee observed a qualifying interaction with the business; other reviews are labelled Unverified and carry no ranking weight. The label describes the review only and does not change the business's verification or publication.

get_business_reviews

Returns the public Trust Card for one published business, found by business_id or domain_key: its Verified or Listed class and disclosure, public profile facts, review summary, commercial reach disclosure, available actions and citation, and any owner-provided insurance details with a note that Loppee has not confirmed them. It contains no numeric verification score.

get_trust_card

Returns the signed-in customer's own conversations with businesses, or one thread by conversation_id, paged with cursor. It reads only this customer's inbox and does not send messages. Requires the connection's permission to read messages.

list_my_conversations