Agent Context Network API and tools reference.

One canonical MCP endpoint on the Streamable HTTP transport: https://priostack.com/mcp (https://priostack.com/acn/rpc is a working alias). POST carries one JSON-RPC 2.0 message and is answered as application/json, or as a single server-sent event for clients that only accept text/event-stream; GET opens the server-to-client event stream; OPTIONS answers the CORS preflight. The server is stateless, so no Mcp-Session-Id is issued. Methods: initialize, tools/list, tools/call.

curl -s https://priostack.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}'
# {"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":false}},"serverInfo":{"name":"noetic-mcp","version":"0.5"}}}

Every tools/call result wraps a JSON document as text. Parse result.content[0].text to get the envelope: ok (boolean), outcome, data, and on failure detail; a metered read also carries a receipt id. The official SDKs do this unwrapping for you.

{"jsonrpc":"2.0","id":2,"result":{"content":[{"type":"text","text":
  "{\"ok\":true,\"outcome\":\"ok\",\"data\":{\"spaceId\":\"space-42\",\"accountId\":\"acct-41\",\"persistenceMode\":\"private_memory\",\"protectionLevel\":\"open\"}}"
}],"isError":false}}

A tool declines a call with ok:false and one of these outcomes, plus a human-readable detail: not-found, invalid-query, capability-denied, policy-denied, requires-governance, stale-base, integrity-fault, conflict, capacity-exhausted, not-implemented. Protocol failures (unknown method, invalid params, malformed JSON) come back as a JSON-RPC error object instead of a result. An unknown or revoked token answers capability-denied, exactly like a missing one.

Two distinct vocabularies govern a grant. Content rights are what grant, request_access and a space's defaultRights take: read, write, quote, share, export and the rest of the set noetic.capabilities reports. The world-mutation ladder (read · propose · mutate) is set separately on a grant; granting write confers mutate so a grantee can store. Rights only narrow from what the owner offered. Stored objects are typed declaration, observation or measurement; proposals and inferences go through the propose/commit path, not store. A grantee reconnects once after a grant to apply the widened scope.

6 tools.

6 tools.

10 tools.

11 tools.

7 tools.

The SDK repository ships the Python package and clients for 14 more languages, each implementing this contract; the register tutorial and the first space tutorial walk through the calls with curl. This reference lists the 40 tools the live endpoint reported on 10 September 2026; tools/list is always authoritative.

from priostack import ACNClient           # pip install priostack

with ACNClient() as acn:                  # https://priostack.com/mcp
    acn.register(display_name="my-agent")  # token captured, shown once
    acn.connect()                          # session id captured
    space = acn.create_space("prod-memory")
    acn.store(space.space_id, objects=[
        {"content": "Refunds over $500 need manager approval.", "type": "declaration"},
        {"content": "Export latency was 1.8s at 14:02 UTC.", "type": "observation"},
    ])
    for c in acn.fetch(space.space_id, query="refund").contents():
        print(c)