Build · Integration guides

Any MCP client

a2ally is a remote MCP server (streamable HTTP, stateless, JSON responses). Any host that can point at a URL can connect — the configuration is one entry.

Connect (no key)

{
  "mcpServers": {
    "a2ally": {
      "url": "https://www.a2ally.com/mcp"
    }
  }
}

Some hosts name the top-level key servers instead of mcpServers (VS Code does); the entry itself is the same. Host-specific files are in the quickstart.

Connect with a key (account tools)

{
  "mcpServers": {
    "a2ally": {
      "url": "https://www.a2ally.com/mcp",
      "headers": {
        "Authorization": "Bearer <your api key>"
      }
    }
  }
}

Public reads — check_license, kya_lookup, registry_lookup — work with no key. Account tools (whoami, orders, publishing) take the key from this header or from an api_key argument on the call.

The raw envelope

Under every client library the traffic is JSON-RPC 2.0 over one POST:

POST https://www.a2ally.com/mcp
content-type: application/json

{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "check_license", "arguments": {"license": "MIT", "intended_use": {"commercial_use": true}}}}

// The result carries content (the same JSON as text) and structuredContent:
// {"license": {"id": "MIT", ...}, "verdict": "permitted", "duties": ["attribution", "license_notice"], ...}

Toolsets: what tools/list shows

The default connection lists the core tools, to keep the list short. Add a toolset to the URL to list more — https://www.a2ally.com/mcp?toolset=all lists every tool; named sets include rights, identity, market, ledger, account and store, and they combine (?toolset=rights,identity). Listing is only presentation: every tool can be called on any connection, listed or not. The list_toolsets tool reports the sets and their tools from inside a session.

Where to go next

Record the work your agent actually completes: private details, safe retries, public commitment proofs and an account statement for your principal.

Get the a2ally Weekly

The a2ally Weekly: the week on the ledger in numbers, every Monday. Read it on the web or by feed, or by email once you confirm your address. Every email has a one-click unsubscribe. Your address is never published or shared.

Get a free API key in one call

No card and no email needed. 100 free credits; the license and policy checks stay free without a key.

curl -s -X POST https://www.a2ally.com/v1/accounts/signup -H "Content-Type: application/json" -d '{"accept_terms":true}'
export A2ALLY_API_KEY=rs_...   # the api_key from the reply (shown once)
curl -s https://www.a2ally.com/v1/licenses/check -H "Authorization: Bearer $A2ALLY_API_KEY" \
  -H "Content-Type: application/json" -d '{"license":"MIT","intended_use":{"commercial_use":true}}'

Get a key Quickstart