FOR TEAMS ON RAFT
Are you found by AI? measures how AI engines describe and recommend businesses, and who they name instead. With this app, your Raft agent reads your reports and works through the fixes with you.
Login with RaftPublished on the Raft Marketplace.
Install the app from your own server's Marketplace view.
You need to be that server's owner or an admin.
Open this address in your browser, with your server's slug in place of the highlighted part:
https://app.raft.build/s/<your-server-slug>/settings/applications?marketplace_app=found-by-ai-preview-5685a3There is no global install button. Each server installs the app from its own Marketplace view, and the address above takes you straight to it.
Your server's slug is the part of its Raft address that comes after /s/.
If you are not the owner or an admin, send this page to the person who is.
Once the app is installed, agents on that server can ask for a connection.
Opening the link alone shares nothing.
Ask your agent to connect, then approve its request in your browser.
Every optional permission starts off. You can switch on extras if your agent needs them. A share lasts thirty days unless you end it sooner.
Your agent can run these commands from a Raft server where the app is installed:
raft integration login --service found-by-ai-preview-5685a3
raft integration invoke --service found-by-ai-preview-5685a3 --list-actions
raft integration invoke --service found-by-ai-preview-5685a3 --action begin-connectionThe response to begin-connection includes the approval link. If ten minutes pass before you open it, ask your agent to start a new connection.
Leave the optional permissions off for report-only access. The optional permissions let your agent read your workspace history, save drafts in your workspace, check a page's title or description against a saved draft, and request or cancel a free re-check.
If you switch on a workspace action, reading your workspace history comes with it.
To stop sharing, choose Revoke access on your connections page.
Open your connections pageYour agent can read the questions asked, each engine's answer, whether the business was named and cited, the date each answer was measured, and the report's suggested fixes, rivals and limitations. Reading a report does not run a scan.
Your agent cannot publish website changes or buy paid scans. It cannot read reports you did not pick.
Revoking blocks later actions. It does not cancel work that is already queued or running. If a free re-check is queued and you do not want it to run, cancel it before you revoke. A re-check that is already running cannot be stopped.
These are the actions your agent can call, by name. Your agent can also end a connection itself.
get-session-contextRead verified Raft identity and connection status: whether an owner has approved, shared reports, each permission on or off, expiry and next steps. Call this first when another action returns nothing or is refused.
begin-connectioncreate the ten-minute request for an owner to share selected saved reports. This call grants no access.
get-linked-reportslist only the saved reports an owner explicitly shared with this identity and that are still available to them.
read-saved-reportread a shared report: the questions asked, each engine's answer, whether the business was named and cited, the date each answer was measured, and the report's suggested fixes, rivals and limitations. It does not run a scan.
revoke-connectionend one of its connections. Later reads are refused.
read-workspaceread the owner's workspace history for a shared report. Only when the owner has switched this on.
save-workspace-draftsave a proposed change as a draft in the owner's workspace. Saving a draft does not publish anything to the website. Only when switched on.
check-workspace-pagecompare a page's raw HTML title or description with the saved expectation. It does not run a new AI measurement. Only when switched on.
request-workspace-recheckask for a free re-check within the account's existing weekly limits. It can call AI providers and send a result email. A queued request has not been measured yet. Only when switched on.
cancel-workspace-recheckcancel a queued re-check. It cannot stop one already running. Only when switched on.
Ask your agent to run get-session-context first.
It tells your agent whether the owner has approved the connection, which reports are shared, which permissions are on or off, when the share ends and what to do next.
This is the most common cause. Opening the approval link shares nothing on its own. The account owner signs in, ticks at least one saved report and chooses Share selected reports.
Approval links last ten minutes. Ask your agent to run begin-connection again, then open the new link straight away.
A share lasts 30 days. After that your agent can't read the reports until the owner approves a new connection. Ask your agent to run begin-connection again.
Drafts, page checks and free re-checks each need their own permission, and every one starts off. Permissions are set when the owner approves, so ask your agent to run begin-connection and tick the permission you want on the approval page. You can then revoke the older connection on your connections page.