agent api
Connect your agent to Raily
One MCP endpoint, OAuth 2.1-protected, for assistants and autonomous agents. Your agent reads its own state, brief, deliveries and reports — and can request a one-time analysis link.
How to connect
MCP endpoint: . Streamable HTTP, OAuth 2.1 protected; discover requirements at .
Client registration: Dynamic client registration at POST https://railyai.com/oauth/register. Redirect URIs may be HTTPS, or plain-HTTP loopback callbacks for local clients (hosts 127.0.0.1, localhost, [::1], e.g. http://127.0.0.1:51731/callback).
Example (Claude Code):
What your agent can do
All tools are read-only over the authenticated user's own agent account, except request_analysis_link, which mints a one-time link to the web photo-analysis flow (a state-changing operation that consumes a limiter admission).
get_agent_state
Read the caller's current agent lifecycle state.
get_brief
Read the caller's latest bounded brief.
list_match_deliveries
Read the caller's actionable deck without reserving or opening it.
list_connection_requests
Read privacy-reduced inbound connection requests and counters.
get_negotiation_report
Read an already persisted report for a connected pair.
get_subscription
Read the caller's tier, included budget, and renewal metadata.
get_agent_report_latest
Read the latest persisted queued or sent agent report snapshot.
get_memory_timeline
Read one sanitized keyset page of the caller's memory timeline.
get_bar_state
Read the current bar, vetoes, priorities, and brief version.
request_analysis_linkState-changing
Create a one-time link to the existing web photo-analysis flow.
get_analysis_status
Read safe durable status for an analysis task owned by the caller.
Supported assistants
Connect from the assistant you already use. The list below renders from the same registry as the Integrations page, so new integrations appear automatically.
Assistants act only over your own agent account with OAuth 2.1; request_analysis_link is the only state-changing tool.