Skip to content

Agent Access

Autonomous agents can create streams, record video, query analytics, and pay per-use without a human signup. FrameWorks exposes the same platform via MCP tools, GraphQL, and HTTP, with wallet-based identity and x402 micropayments so an agent can self-onboard, get challenged for payment on a billable call, top up via submit_payment, then retry.

  1. Request a wallet challenge from POST /auth/wallet-challenge or MCP request_wallet_challenge, sign the returned message, and exchange it at POST /auth/wallet-login or once through the MCP wallet headers.
  2. Call the API operation you need via MCP or GraphQL with the resulting session or API token.
  3. If a rated operation needs payment, read the HTTP 402 / INSUFFICIENT_BALANCE response and its x402 payment requirements.
  4. Sign an EIP-3009 USDC authorization for one accepted network.
  5. Submit the payment through GraphQL submitX402Payment or MCP submit_payment; retry the identical payment while pending, then retry the rated operation without the payment header after confirmed credit.

FrameWorks publishes metadata following the Agent Skills open standard so agents can discover and connect automatically.

URLStandardPurpose
/.well-known/mcp.jsonMCPServer discovery: endpoint, transports, auth schemes, public operations
/.well-known/did.jsonW3C DIDDecentralized identity and service endpoints
/.well-known/oauth-protected-resourceRFC 9728OAuth resource metadata with wallet and x402 extensions
/.well-known/security.txtRFC 9116Security contact and advisories
/skill.jsonAgent SkillsMachine-readable skill metadata (name, auth, endpoints, keywords)
/SKILL.mdAgent SkillsHuman/LLM-readable quick-start guide
/llms.txtEmergingLLM-friendly documentation index
/robots.txtStandardCrawler directives (allows AI bots)

The primary machine-readable entry point. Compatible with OpenClaw, Claude Code, Cursor, Gemini CLI, and other Agent Skills consumers.

Live file: https://frameworks.network/skill.json

Agents that speak MCP can use /.well-known/mcp.json directly for full server discovery — endpoint, transports, auth schemes, public operations, and capabilities.

Live file: https://bridge.frameworks.network/.well-known/mcp.json

Install as a local skill for coding agents:

Terminal window
# Claude Code
mkdir -p ~/.claude/skills/frameworks-network
curl -o ~/.claude/skills/frameworks-network/SKILL.md https://frameworks.network/SKILL.md
# OpenClaw (via ClawHub)
clawhub install frameworks-network
# OpenClaw (manual)
mkdir -p ~/.openclaw/skills/frameworks-network
curl -o ~/.openclaw/skills/frameworks-network/SKILL.md https://frameworks.network/SKILL.md
# Gemini CLI / Cursor / other Agent Skills consumers
mkdir -p ./skills/frameworks-network
curl -o ./skills/frameworks-network/SKILL.md https://frameworks.network/SKILL.md

Once installed, the agent can activate the skill on demand to connect to and operate FrameWorks.

Two methods, both stateless, no registration required:

MethodBest ForDetails
Wallet (EIP-191)Autonomous agentsSign a message, auto-provision a tenant. See Wallet Auth.
Bearer (JWT)Dashboard users, API keysFrom login or account settings.

x402 (EIP-3009 USDC on Base/Arbitrum) tops up an authenticated tenant; it is never a login credential. The one anonymous payment is viewer:// playback, which credits the content owner without establishing an identity. See Payments.

What agents can do via MCP:

CategoryOperations
StreamsCreate, update, delete, refresh keys, monitor health
ClipsCreate from live or recorded streams, delete
DVRStart/stop catch-up recording
VODUpload, complete, abort, delete video assets
PlaybackResolve viewer endpoints with geo-routing
BillingTop up with x402 or crypto deposit (ETH or USDC), check deposits, update billing details
AnalyticsUsage aggregates, viewer metrics, geographic distribution
QoE DiagnosticsRebuffering, buffer health, packet loss, routing, anomalies
SupportSearch past conversations
API ExplorationIntrospect GraphQL schema, generate queries from templates

See the full MCP Reference for the current tools, resources, and prompts catalog.