Skip to content
LogoLogo

Manage with an agent

Run your pricing from a prompt

View as Markdown

The Radius platform MCP server gives an agent the same controls as the Merchant Console. The agent signs in as you and acts with your permissions, so it can do what your role allows and nothing more.

Connect your agent

The server is at https://platform-api.radiustech.xyz/mcp. In the Merchant Console, Connect agent at the foot of the sidebar shows the snippet for your agent.

  • Claude Code. Run claude mcp add --transport http radius-platform https://platform-api.radiustech.xyz/mcp, then run /mcp and choose Authenticate.
  • Codex. Run codex mcp add radius-platform --url https://platform-api.radiustech.xyz/mcp, then sign in when Codex asks.
  • Cursor. Add the server to .cursor/mcp.json, then sign in from Cursor's MCP settings.
  • OpenCode. Add the server to opencode.json, then run opencode mcp auth radius-platform.

For Cursor:

{
  "mcpServers": {
    "radius-platform": {
      "url": "https://platform-api.radiustech.xyz/mcp"
    }
  }
}

Any other MCP client that supports remote servers with OAuth connects with the same URL.

What to ask

Ask in plain words. The agent picks the tools.

  • "Import the OpenAPI spec in this repository into my Reports API project and charge 0.002 USD per call."
  • "Which endpoints earned the most last week?"
  • "Raise the price of the two busiest endpoints by 25%, then publish the catalog."
  • "Is my gate on the current policy version?"

To import from your API's codebase, open the project's Endpoints page, select Import OpenAPI spec, and copy the prompt on the Agent tab. A connected agent can also ask the server for the same instructions as the import_openapi_spec prompt.

Reprice on a schedule

Prices are meant to move. The same request can run on a schedule, so pricing follows demand without anyone watching it:

  1. Read what was paid. get_earnings totals settled payments per endpoint for a time window.
  2. Compare with the policy. get_policy returns the current rules and prices.
  3. Reprice what changed with update_endpoint. Each save is a new policy version you can review in the console.
  4. Enforce without a deploy. Your gate syncs the new version within a minute. get_gate_status confirms it.

Tools

Projects

ToolWhat it does
whoamiYour user, organization and permissions
list_projectsThe organization's projects with their endpoint counts
get_projectOne project with its endpoints and a summary of its policy
create_projectCreates a project in test mode with a default policy
update_projectRenames a project or sets its base URL
archive_projectArchives a project, so gates refuse its requests
restore_projectRestores an archived project

Endpoints and policy

ToolWhat it does
propose_endpoints_from_specProposes endpoints and rules from an OpenAPI 3 document, saving nothing
create_endpointAdds one endpoint with its rules
create_endpointsAdds several endpoints in one policy version
update_endpointChanges an endpoint's name, methods, path, rules or wallet
get_policyThe project's policy as JSON or YAML
put_policyReplaces the whole policy
set_policy_modeSwitches a project between test and live
list_payment_optionsThe networks and tokens a policy can accept

Gate

ToolWhat it does
get_gate_statusWhether gates are enforcing the project's current policy
get_compiled_policyThe compiled document gates fetch and enforce

No tool creates or returns a connector key. Generate it on the project's Gate page, so the key never passes through an agent's context. See set up a gate.

pricing.md

ToolWhat it does
get_pricing_mdThe organization's pricing.md and where it is served
publish_pricing_md_catalogPublishes one project's catalog
unpublish_pricing_md_catalogTakes one project's catalog out of the file

Wallets and payments

ToolWhat it does
list_walletsThe organization's registered wallets
register_walletRegisters an EVM address your organization controls
archive_walletStops a wallet being chosen for payouts
restore_walletMakes an archived wallet available again
list_paymentsPayments, newest first, with endpoint, payer, token and status
get_earningsSettled payments totalled per network, token and endpoint

Permissions

A tool call fails when your role lacks the permission the same action needs in the console: endpoints:write to change rules or publish, projects:write to create or rename a project, wallets:write to register a wallet. Ask an organization admin to change your role.