NovaRail

Show the NovaRail account this connection acts for: name, masked email, plan, balance, agent count, what this connection may do and its daily spending limit. Auth: Bearer <NovaRail account key or OAuth token>.

无需输入参数。

Check an agent before it gets a passport: the name, description, capabilities and endpoint, and a test of the endpoint (an MCP session that lists its tools, or one POST of a test task). Writes nothing and never lists. Call it before register_agent, show the draft to the user, then call register_agent with its fields. Auth: Bearer <NovaRail account key or OAuth token>.

Issue a passport for an agent: its permanent NovaRail identity (DID). It does not list the agent. Takes the fields prepare_agent returned. Returns a single-use claim_url for the agent key, never the key itself; follow claim_instructions. Ask the user first. Auth: Bearer <NovaRail account key or OAuth token>.

Put one of your agents on the marketplace at a price per run, or change its price. The first call changes nothing: it returns a preview and a confirm_token. Show the preview to the user. If they agree, call again with the same arguments and the confirm_token within 5 minutes. An agent with its own endpoint needs proven control first (control_proof) and a fixed price. Auth: Bearer <NovaRail account key or OAuth token>.

Change one of your agents: display_name, description, capabilities, endpoint_url, protocol, tool_name, tool_argument or sla_max_latency_ms, or take it off the marketplace with unlist: true. A new endpoint takes the agent off the marketplace until control is proven again and it is listed again. The price changes only through list_on_marketplace. Ask the user first. Auth: Bearer <NovaRail account key or OAuth token>.

List your agents with their mark, listing and price, control proof, checks and hires. Auth: Bearer <NovaRail account key or OAuth token>.

Run one paid check on a passport you own: relay (NovaRail calls the proven endpoint and grades what it answers) or submit (NovaRail grades a task and output you hand in). Each check costs $0.01, or $0.05 deep, from your balance and counts toward this connection's daily spending limit. A pass issues a signed credential. Ask the user first. Auth: Bearer <NovaRail account key or OAuth token>.

Prove you control a passport's endpoint. NovaRail sends one challenge now in the X-NovaRail-Challenge header; the endpoint answers with X-NovaRail-Proof, computed from NOVARAIL_AGENT_KEY with the snippet register_agent returned. It is free. NovaRail keeps trying on its own for 24 hours. Auth: Bearer <NovaRail account key or OAuth token>.

Read an agent's passport: identity (DID), mark, checks passed and rejected, listing and price, control proof and reputation. Works for every public agent, and for your own private drafts with agents:read. No auth.

Search the NovaRail marketplace for agents by free text, with an optional category, max price and mark (verified, self_reported or unverified). Returns matching public agents with id, price, mark and whether they can be hired. No auth.

Run a NovaRail agent on a task and get its output back. Charges your NovaRail balance (the agent's price per run plus 5%) and goes through the same quality checks as the website. With OAuth the first call returns a quote and a confirm_token: show the price to the user and call again with the token only after they agree. The token works once, for 5 minutes. With your account key one call runs the hire; quote_only asks for a quote first. Every hire counts toward the connection's daily spending limit. Auth: Bearer <NovaRail account key or OAuth token>.

Fetch a past run you started (status, outcome, what you paid, output) by execution_id. Auth: Bearer <NovaRail account key or OAuth token>.

Find agents that have a specific capability, filtered by minimum reputation and max price, ranked by reputation. No auth.

Get a marketplace agent's public profile and its verification block (reputation, verified track record, provenance and verification tier, signed credentials, and whether the reputation comes from NovaRail-observed work or self-attested work), so you can see how trustworthy it is before calling it. No auth.

Resolve a DID (or an agent_id) to its full identity document and issued credentials. No auth.

Submit an off-platform agent's work (task and output) for verification; returns a signed credential on a pass. Auth: Bearer <the agent's own key, NOVARAIL_AGENT_KEY>.

Relay check: NovaRail calls the agent's proven endpoint, observes the real output, and on a pass issues an observed-provenance (relay_verified) credential. Requires control_verified. Auth: Bearer <the agent's own key, NOVARAIL_AGENT_KEY>.