MCP server

Autonomous Agents Network (AANet)

space.aanet/aanet-mcp

Checked 28 Oct 2026, 09:03 UTC · Connected to it and listed its tools

Multi-agent coordination outside your LLM context: dedupe parallel work, per-agent budgets, handoff

Website

At a glance

Type

MCP server

Publisher

aanet.space (verified by the MCP Registry)

Status

Working at last check

Tools

34

Token cost

About 16,654 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

28 Oct 2026, 09:03 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http aanet-mcp https://aanet.space/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.aanet-mcp]
url = "https://aanet.space/mcp"

Gemini CLI

{"mcpServers":{"aanet-mcp":{"httpUrl":"https://aanet.space/mcp"}}}

Cursor

{"mcpServers":{"aanet-mcp":{"url":"https://aanet.space/mcp"}}}

VS Code

{"servers":{"aanet-mcp":{"type":"http","url":"https://aanet.space/mcp"}}}

Antigravity

agy mcp add aanet-mcp https://aanet.space/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"aanet-mcp","server_url":"https://aanet.space/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"aanet-mcp","server_url":"https://aanet.space/mcp"}

Tools

• aanet_acquire_lock ~723 tokens
  Claim exclusive ownership of a named unit of work so no other sub-agent starts the same thing — call this before starting work, not after. Returns {lease_expires_at, fence} on success, or a 409 if another sub-agent already holds an unexpired lease on the same name (that conflict is f
• aanet_append_file ~804 tokens
  Append one entry to a file without touching what's already there, creating the file if it doesn't exist yet — use aanet_write_file instead when you need to replace the whole file. Typical use: a shared log or running notes file multiple sub-agents contribute to. Fires a file_write we
• aanet_create_trial_workspace ~338 tokens
  Create a free trial workspace — no payment, no arguments, works immediately. Use this instead of aanet_create_workspace when you want to exercise the API (files, locks, sub-keys, messages) before committing real money. Pre-funded with a small fixed balance (currently 1000 units = $0
• aanet_create_workspace ~265 tokens
  Create a real AANet workspace with a prepaid USDC balance — the entry point for an orchestrator agent starting a new swarm task. Use aanet_create_trial_workspace instead if you want to explore the API before paying anything. On success, returns {workspace_id, label, owner_key, creat
• aanet_delete_file Changes files · Deletes data · ~565 tokens
  Permanently remove a file — the missing piece of the file lifecycle alongside aanet_read_file/aanet_write_file/aanet_append_file. There is no undo: to recover, a sub-agent would need its own backup of the content. Fires a file_delete webhook event on success (see aanet_register_webho
• aanet_delete_webhook Deletes data · ~316 tokens
  Permanently remove a registered webhook — no further events will be delivered to it, active or auto-disabled. Owner_key required. There is no way to temporarily pause one; delete and re-register with aanet_register_webhook if you want it back later (you'll get a new secret).
• aanet_delete_workspace Deletes data · ~369 tokens
  Permanently and irreversibly delete a workspace: every sub-key, all files, the activity log, and any registered webhooks are destroyed along with it — there is no undo and no trash/recycle bin. Requires the owner_key; a sub-key gets a 403. Call aanet_request_refund first if the work
• aanet_deposit ~583 tokens
  Fund a real workspace via the x402 protocol — a two-step call using the same tool both times. This does not accept trial workspaces (use aanet_create_workspace for a fundable one) and requires the owner_key. Step 1 — call with only api_key/workspace_id/amount_usd: returns an x402 Pa
• aanet_estimate_savings ~359 tokens
  Estimate the cost of coordinating a swarm on AANet versus relaying the same coordination through your orchestrator's LLM context — before you create a workspace or spend anything. Same formula as the calculator at https://aanet.space/#savings. AANet side assumes ~16 units/round (the
• aanet_export_activity ~381 tokens
  Export the hash-chained (OK) audit rows in ascending order with prev_hash/entry_hash, plus the signed head of the whole chain. Page forward with since_seq = the last chain_seq you got. Verify it yourself with the ~25-line verify_chain function in AGENTS.md (recompute each entry_hash from
• aanet_get_activity ~648 tokens
  Read the server-side audit log of every attempt in this workspace, successful or rejected — the authoritative source of what each sub-agent actually did, since sub-agents can't fake or skip this the way they could misreport their own actions. Owner_key required. Each entry has subke
• aanet_get_activity_head ~348 tokens
  Signed tip of the workspace's tamper-evident activity chain: every successful (OK) audit row is hash-linked to the previous one, and this returns {seq, entry_hash, signed_at, key_id, algorithm, signature} - an Ed25519 signature by the service over that tip. Save it OUTSIDE AANet (any key
• aanet_get_activity_summary ~370 tokens
  Spend totals from the audit log instead of reading every entry: for each group, total_cost (units) and calls. Use it to see which sub-agent is burning budget before adjusting a budget_cap via aanet_update_subkey. Owner_key required. An unknown group_by is an error.
• aanet_get_forecast ~364 tokens
  Burn rate and runway: the workspace balance, spend per hour over the last 1h / 24h / 7d (each window shortened to the workspace's age if it is younger) with the hours the balance would last at that pace, and the top spending sub-keys of the last 24h. Each window states the interval it wa
• aanet_get_lock_status ~413 tokens
  Check a lock WITHOUT trying to take it, and tell "nobody ever took it" apart from "someone took it and released it" — a free lock and an already-finished task look identical from aanet_acquire_lock alone. Returns status held | expired (lease ran out, not yet reclaimed) | free (taken befo
• aanet_get_messages ~768 tokens
  Fetch messages sent via aanet_send_message — the pull-based fallback for when you haven't registered a webhook on the message event. With `wait` > 0 the call parks until a matching message arrives (or the timeout), so an agent that cannot receive webhooks can listen without a tight p
• aanet_get_pricing ~163 tokens
  Free, no key needed: the machine-readable price list — cost in units ($0.00001 each) of every operation (base + per started KB where it applies, and when it is free), the minimum deposit, file-size and webhook limits, trial terms and the idle-storage fee. Same document as GET /pricing. U
• aanet_get_refund_status ~332 tokens
  Check the status of every refund request ever made for a workspace — the way to find out whether an aanet_request_refund call actually got paid. Owner_key required. Each entry has status ("pending", "paid", or "rejected"), and tx_hash once paid — verify that transaction on-chain your
• aanet_get_remaining_balance ~380 tokens
  Free (never charged): how much this key can still spend, so you can stop before a 402 instead of discovering it mid-sequence — the MCP counterpart of the REST X-AANet-Remaining-Balance header. Takes only the key; works for the owner_key or any sub-key, against itself. Returns `remai
• aanet_get_webhook_deliveries ~429 tokens
  Inspect one webhook's delivery history — use this to debug a webhook that seems to have gone quiet (check aanet_list_webhooks first to see if it's been auto-disabled) or to confirm an event actually fired. Owner_key required. Each entry has event_type, status_code (null if the reques
• aanet_get_workspace ~360 tokens
  Check a workspace's current balance and status — the read-only counterpart to every other workspace tool. Works with the owner_key or any sub-key issued under it (not restricted to the owner). Returns deposit_balance and total_spent in raw integer units ($0.00001 each), plus is_tria
• aanet_list_subkeys ~286 tokens
  List every sub-key ever issued under a workspace (including revoked ones), with each one's scope, budget_cap, window/rate limits, and spent_so_far — the inventory view that complements aanet_get_activity's per-event log. Owner_key required; raw key values are never included since they're
• aanet_list_webhooks ~345 tokens
  List webhooks registered on a workspace — url, subscribed events, consecutive_failures (failed attempts since the last success), and disabled_at/disabled_reason if it was auto-disabled after 10 failed attempts in a row (you also get an aanet.system message when that happens; deliveri
• aanet_mint_subkey ~915 tokens
  Issue a new scoped credential for one sub-agent — the standard way to bring a sub-agent into an existing workspace. Requires the owner_key; a sub-key cannot mint another sub-key. Returns {subkey_id, key} where key is shown exactly once, the same as owner_key at workspace creation. G
• aanet_read_file ~378 tokens
  Read a file's content, or list a directory's entries if path points to one — the read counterpart to aanet_write_file/aanet_append_file. Costs 1 unit per hit (file or directory); a missing path returns 404 and is free. Returns {path, content, is_dir, entries, etag}; for a directory, cont
• aanet_register_webhook ~1030 tokens
  Register a push endpoint so this workspace calls you instead of you calling aanet_get_activity/aanet_get_messages/aanet_acquire_lock in a polling loop — the main alternative to polling anywhere in this API. Owner_key required; up to 5 active webhooks per workspace. Returns {webhook_
• aanet_release_lock ~374 tokens
  Voluntarily give up a lock you hold, immediately, instead of waiting for its lease to expire — always call this as soon as you're done with the unit of work, so a sub-agent waiting on it doesn't idle unnecessarily. Free (no charge), unlike acquire/renew. Fails with 404 if nobody hold
• aanet_renew_lock ~510 tokens
  Extend a lock you currently hold, before its lease runs out — call this instead of aanet_acquire_lock again while work is still in progress. Fails with 404 if nobody holds the lock, or 403 if a different sub-key is the current holder (you can't renew someone else's lease). Returns {l
• aanet_request_refund Moves money · ~516 tokens
  Ask for a workspace's entire remaining balance back, when its task is done and money is left over — call this before aanet_delete_workspace, not after. Owner_key required; trial workspaces reject this outright (they never held real money). This reserves (zeros out) the full balance
• aanet_revoke_subkey Changes accounts · ~367 tokens
  Permanently revoke one sub-agent's credentials — every subsequent call with that key gets a 401. Use this when a sub-agent is compromised, misbehaving, or simply finished, without affecting any other sub-key in the workspace. Owner_key required. Immediately releases any lock the rev
• aanet_send_message Sends messages · ~636 tokens
  Send a one-shot signal directly to another sub-agent (or to everyone), for things that don't belong in a file — e.g. "chunk 3 done" or "aborting, don't wait on me". Use aanet_write_file / aanet_append_file instead for anything that needs to persist as durable state; messages are mean
• aanet_submit_feedback ~526 tokens
  Report a bug, request a feature, or flag that pricing feels wrong — this is the one feedback channel into how the operator prioritizes what to build next, not a support ticket that gets a reply. Any valid, unrevoked key can call this, owner or sub-key. Returns {feedback_id, status} w
• aanet_update_subkey ~661 tokens
  Change a live sub-key's scope and/or budget cap without revoking and reissuing it — use this instead of aanet_revoke_subkey + aanet_mint_subkey when the sub-agent's credentials themselves should keep working (e.g. widening its file scope mid-task, or raising a budget cap it hit). Own
• aanet_write_file Changes files · ~832 tokens
  Overwrite a file's entire content, creating it if it doesn't exist — use aanet_append_file instead if you want to add one entry without replacing what's there. Fires a file_write webhook event on success (see aanet_register_webhook). Pass if_match with the file's last-known etag to

Browse

• Domains and DNS
• Payments
• Calling other AI models
• Crypto and blockchains

Related MCP servers

• Axint
  Proof and repair for Apple coding agents: validate Swift, run Xcode evidence, and repair failures.
• Warmth Engine Observatory
  Coordination Intelligence: AI infrastructure coordination dynamics across geopolitical blocs
• ProfitCollector
  22 pay-per-call developer, security, network and data utilities using x402 on Base.
• AgentIndex x402
  Jev-powered decisions, web search, PDF/web to Markdown, summarize. From $0.001, no API key.
• Buildagents
  Design AI agent teams for a business problem and generate ready-to-paste Claude Code prompts.
• Diogenes Autonomous Microservice Gateway
  Autonomous AI microservices: 55 dynamic guardrails, contract audits & oracles via L402/x402/MPP.
• Oids
  Oids — the communications layer for AI agents: DMs, rooms, coordination.
• Minia2a
  minia2a.uk — hosted MCP over streamable HTTP: call 1,600+ x402 pay-per-call APIs, USDC on Base.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/space.aanet/aanet-mcp.svg)](https://aptlynx.net/servers/space.aanet/aanet-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents