Servidor MCP
AANet
space.aanet/aanet-mcp
Qué hace este MCP
Provides agent-swarm workspaces with scoped subkeys, shared files, locks, messaging, webhooks, budgets, audit logs, and refunds.
Capacidades
Herramientas
27
herramientas
aanet_acquire_lock
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} on success, or a 409 if another
sub-agent already holds an unexpired lease on the same name (that
conflict is free â you are not charged for losing a race).
You do not hold the lock forever: once lease_seconds elapses, anyone can
acquire it out from under you, even if you're still working. Call
aanet_renew_lock periodically while still working, and
aanet_release_lock the moment you're done so others don't wait out the
full lease unnecessarily.
Esquema de entrada
{'type': 'object', 'title': 'aanet_acquire_lockArguments', 'required': ['api_key', 'workspace_id', 'name', 'lease_seconds'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'description': 'Lock name identifying the unit of work, e.g. "process-batch-3".'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}, 'lease_seconds': {'type': 'integer', 'title': 'Lease Seconds', 'maximum': 3600, 'description': 'How long you hold the lock before it becomes reclaimable by anyone else, 1-3600 seconds.', 'exclusiveMinimum': 0}}}
aanet_append_file
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 webhook event on success. Rejected with 413, before writing
or charging, if the resulting file (existing content + this append)
would exceed 1 MiB. Returns {path, appended, etag}.
Esquema de entrada
{'type': 'object', 'title': 'aanet_append_fileArguments', 'required': ['api_key', 'workspace_id', 'path', 'content'], 'properties': {'path': {'type': 'string', 'title': 'Path', 'description': 'Virtual file path within the workspace.'}, 'stamp': {'type': 'boolean', 'title': 'Stamp', 'default': False, 'description': 'Same attribution-comment option as on aanet_write_file, applied to this appended entry.'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'content': {'type': 'string', 'title': 'Content', 'description': 'Text to append as a new entry â\x80\x94 the existing content is kept.'}, 'if_match': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'If Match', 'default': None, 'description': "The file's current etag, for the same conflict-detection purpose as on aanet_write_file."}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_create_trial_workspace
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 100 units = $0.001) and
expires exactly 24 hours after creation, regardless of remaining
balance or activity â it is then deleted permanently along with
everything in it. Returns the same shape as aanet_create_workspace plus
trial_expires_at. aanet_deposit and aanet_request_refund both reject a
trial workspace outright, since no real money ever entered it. If your
task won't fit in 24 hours, create a real workspace instead.
Esquema de entrada
{'type': 'object', 'title': 'aanet_create_trial_workspaceArguments', 'properties': {}}
aanet_create_workspace
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, created_at}. Store
owner_key immediately: it is generated once, never stored in recoverable
form, and there is no "forgot my key" recovery path â losing it means
losing control of the workspace. The workspace starts with a balance of
0; fund it with aanet_deposit before any metered operation will succeed.
Esquema de entrada
{'type': 'object', 'title': 'aanet_create_workspaceArguments', 'required': ['label'], 'properties': {'label': {'type': 'string', 'title': 'Label', 'description': 'A display name for your own reference â\x80\x94 free text, not required to be unique.'}}}
aanet_delete_file
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_webhook). Raises a 404 if the path doesn't exist, a 409
if it's a directory or if_match doesn't match the current etag. Returns
{path, deleted}.
Esquema de entrada
{'type': 'object', 'title': 'aanet_delete_fileArguments', 'required': ['api_key', 'workspace_id', 'path'], 'properties': {'path': {'type': 'string', 'title': 'Path', 'description': 'Virtual file path within the workspace. Must point to a file, not a directory.'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'if_match': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'If Match', 'default': None, 'description': "The file's current etag, for the same conflict-detection purpose as on aanet_write_file."}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_delete_webhook
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).
Esquema de entrada
{'type': 'object', 'title': 'aanet_delete_webhookArguments', 'required': ['api_key', 'workspace_id', 'webhook_id'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'webhook_id': {'type': 'string', 'title': 'Webhook Id', 'description': 'The webhook_id from aanet_register_webhook or aanet_list_webhooks.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_delete_workspace
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 workspace still has balance you
want back, and wait for aanet_get_refund_status to show "paid" before
deleting â once the workspace is gone, so is any way to claim what was
left. Use this when a task is finished or permanently abandoned, not as
a way to "reset" a workspace you plan to keep using.
Esquema de entrada
{'type': 'object', 'title': 'aanet_delete_workspaceArguments', 'required': ['api_key', 'workspace_id'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_deposit
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
PaymentRequired challenge offering USDC on Base, Polygon, Arbitrum,
Avalanche, and Solana as payment options; nothing is charged yet.
Step 2 â sign that challenge
with your own wallet/x402 client (this tool cannot sign for you) and
call again with the identical amount_usd plus the resulting proof as
payment_signature; on success this verifies and settles against the
facilitator and returns {workspace_id, deposited_units, tx_hash,
network}. A failed or already-used signature raises an error rather than
silently no-op'ing.
Esquema de entrada
{'type': 'object', 'title': 'aanet_depositArguments', 'required': ['api_key', 'workspace_id', 'amount_usd'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'amount_usd': {'type': 'string', 'title': 'Amount Usd', 'description': 'Deposit amount in US dollars as a decimal string, e.g. "1.00". Minimum $0.25.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}, 'payment_signature': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Signature', 'default': None, 'description': 'Leave unset on your first call to receive the payment challenge. Set this to the signed proof from your own x402-aware wallet client on the follow-up call with the same amount_usd, to actually settle the payment and credit the balance.'}}}
aanet_estimate_savings
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 the measured ~16 units/round (1 read + 1 write + 1
lock cycle) at $0.00001/unit. The relay side assumes ~9,600 tokens/round
(re-injecting another agent's update into your prompt) at a blended
$2-$10 per million token rate. This is a rough estimate, not a quote â
real workloads vary; see aanet_get_activity on an actual workspace for
your own measured cost once you're running for real.
Esquema de entrada
{'type': 'object', 'title': 'aanet_estimate_savingsArguments', 'required': ['agents', 'rounds_per_agent'], 'properties': {'agents': {'type': 'integer', 'title': 'Agents', 'maximum': 1000, 'description': "Number of agents in the swarm you're planning.", 'exclusiveMinimum': 0}, 'rounds_per_agent': {'type': 'integer', 'title': 'Rounds Per Agent', 'maximum': 1000, 'description': 'Coordination rounds each agent will need (reads/writes/lock cycles).', 'exclusiveMinimum': 0}}}
aanet_get_activity
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 subkey_id, operation, path, cost_charged, status (e.g.
OK, INSUFFICIENT_BALANCE, SCOPE_DENIED, CONFLICT), and a free-text
detail. Use this to reconstruct what happened after the fact, or to
check a sub-agent's spend pattern before adjusting its budget_cap via
aanet_update_subkey.
Esquema de entrada
{'type': 'object', 'title': 'aanet_get_activityArguments', 'required': ['api_key', 'workspace_id'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 100, 'maximum': 500, 'description': 'Maximum entries to return, newest first, up to 500.', 'exclusiveMinimum': 0}, 'since': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Since', 'default': None, 'description': 'ISO timestamp â\x80\x94 only return entries at or after this time.'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'operation': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Operation', 'default': None, 'description': 'Filter to one operation type, e.g. "PUT_FILE", "LOCK_ACQUIRE", "SEND_MESSAGE", "WEBHOOK_DELIVERY". Omit for all operation types.'}, 'subkey_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Subkey Id', 'default': None, 'description': 'Filter to attempts by this sub-key only. Omit for all.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
Esquema de salida
{'type': 'object', 'title': 'aanet_get_activityOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Result'}}}
aanet_get_messages
Fetch messages sent via aanet_send_message â the pull-based fallback
for when you haven't registered a webhook on the message event. A
sub-key only sees messages addressed to it plus broadcasts (to_subkey_id
was left unset by the sender); the owner_key sees every message in the
workspace, for oversight. There's no read/unread tracking server-side â
track your own last-seen ts and pass it as `since` on the next call,
the same pattern as aanet_get_activity.
Esquema de entrada
{'type': 'object', 'title': 'aanet_get_messagesArguments', 'required': ['api_key', 'workspace_id'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 100, 'maximum': 500, 'description': 'Maximum messages to return, oldest first, up to 500.', 'exclusiveMinimum': 0}, 'since': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Since', 'default': None, 'description': "ISO timestamp â\x80\x94 the ts of the last message you already saw, to fetch only what's new."}, 'topic': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Topic', 'default': None, 'description': 'Filter to messages sent with this exact topic. Omit for all topics.'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
Esquema de salida
{'type': 'object', 'title': 'aanet_get_messagesOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Result'}}}
aanet_get_refund_status
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
yourself before treating the refund as confirmed and deleting the
workspace. A "rejected" entry means the reserved amount was credited
back to the workspace balance, not lost.
Esquema de entrada
{'type': 'object', 'title': 'aanet_get_refund_statusArguments', 'required': ['api_key', 'workspace_id'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
Esquema de salida
{'type': 'object', 'title': 'aanet_get_refund_statusOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Result'}}}
aanet_get_webhook_deliveries
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
request itself never completed, e.g. timeout or DNS failure), and
success.
Esquema de entrada
{'type': 'object', 'title': 'aanet_get_webhook_deliveriesArguments', 'required': ['api_key', 'workspace_id', 'webhook_id'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 50, 'maximum': 200, 'description': 'Maximum delivery records to return, newest first, up to 200.', 'exclusiveMinimum': 0}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'webhook_id': {'type': 'string', 'title': 'Webhook Id', 'description': 'The webhook_id from aanet_register_webhook or aanet_list_webhooks.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
Esquema de salida
{'type': 'object', 'title': 'aanet_get_webhook_deliveriesOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Result'}}}
aanet_get_workspace
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_trial/trial_expires_at (null for a non-trial workspace)
and blocked (true if the operator has manually suspended it, in which
case every metered call returns 403 until unblocked). Call this before a
batch of expensive operations to confirm you won't hit a 402 partway
through.
Esquema de entrada
{'type': 'object', 'title': 'aanet_get_workspaceArguments', 'required': ['api_key', 'workspace_id'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_list_subkeys
List every sub-key ever issued under a workspace (including revoked
ones), with each one's scope, budget_cap, 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
only ever shown once at creation.
Esquema de entrada
{'type': 'object', 'title': 'aanet_list_subkeysArguments', 'required': ['api_key', 'workspace_id'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
Esquema de salida
{'type': 'object', 'title': 'aanet_list_subkeysOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Result'}}}
aanet_list_webhooks
List webhooks registered on a workspace â url, subscribed events, and
whether each is still active or auto-disabled after repeated failures.
Owner_key required. Secrets are never included (only shown once, at
aanet_register_webhook time); use aanet_get_webhook_deliveries for
per-attempt delivery history on one of these.
Esquema de entrada
{'type': 'object', 'title': 'aanet_list_webhooksArguments', 'required': ['api_key', 'workspace_id'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
Esquema de salida
{'type': 'object', 'title': 'aanet_list_webhooksOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Result'}}}
aanet_mint_subkey
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. Give each sub-agent its own sub-key
rather than sharing one across several â that's what makes
aanet_get_activity attributable per sub-agent and what lets you revoke
exactly one misbehaving sub-agent (aanet_revoke_subkey) without taking
down the rest of the swarm.
Esquema de entrada
{'type': 'object', 'title': 'aanet_mint_subkeyArguments', 'required': ['api_key', 'workspace_id', 'label'], 'properties': {'label': {'type': 'string', 'title': 'Label', 'description': "Display name for this sub-key, e.g. the sub-agent's role or id."}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'budget_cap': {'anyOf': [{'type': 'integer', 'exclusiveMinimum': 0}, {'type': 'null'}], 'title': 'Budget Cap', 'default': None, 'description': "Cap this sub-key's own cumulative spend, in the same integer units as the workspace balance ($0.00001 each), even if the workspace has more left. Leave unset for no per-key cap beyond the shared workspace balance."}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}, 'path_scope_prefix': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Path Scope Prefix', 'default': None, 'description': 'Restrict this sub-key to file paths and lock names under this prefix only (least-privilege). Leave unset for unrestricted access to the whole workspace.'}}}
aanet_read_file
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.
Metered per call regardless of file size. Returns {path, content,
is_dir, entries, etag}; for a directory, content is null and entries
lists child names, for a file it's the reverse. Save the returned etag
if you plan to write back â pass it as if_match on aanet_write_file to
avoid clobbering a newer write from another sub-agent.
Esquema de entrada
{'type': 'object', 'title': 'aanet_read_fileArguments', 'required': ['api_key', 'workspace_id', 'path'], 'properties': {'path': {'type': 'string', 'title': 'Path', 'description': 'Virtual file path within the workspace, e.g. "notes/progress.md".'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_register_webhook
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_id, secret} with secret shown exactly once â every
delivery includes an X-AANet-Signature header (HMAC-SHA256 of the raw
body, keyed by that secret); verify it before trusting a payload as
genuinely from us. You are billed for every delivery attempt whether or
not your endpoint responds (WEBHOOK_DELIVERY_COST per attempt, visible
in aanet_get_activity); a webhook that fails 10 times in a row is
auto-disabled â check aanet_get_webhook_deliveries if events stop
arriving. Delivery is best-effort and not durable across a service
restart, so never treat a webhook as your only source of truth â use it
to learn something happened sooner, then confirm with the matching GET
tool if it matters.
Esquema de entrada
{'type': 'object', 'title': 'aanet_register_webhookArguments', 'required': ['api_key', 'workspace_id', 'url', 'events'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'description': 'Must be https:// and resolve to a public (non-private/loopback) address at registration time â\x80\x94 checked once here, not re-checked on every delivery.'}, 'events': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Events', 'description': 'Subset of ["file_write", "lock_available", "message"] â\x80\x94 file_write fires on any successful aanet_write_file/aanet_append_file, lock_available on an explicit aanet_release_lock (not on passive lease expiry), message on aanet_send_message.'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_release_lock
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 holds it or 403 if you're not the current holder. Fires a
lock_available webhook event on success (see aanet_register_webhook) so
a waiting sub-agent can react immediately instead of polling
aanet_acquire_lock in a loop.
Esquema de entrada
{'type': 'object', 'title': 'aanet_release_lockArguments', 'required': ['api_key', 'workspace_id', 'name'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'description': 'Lock name â\x80\x94 must match a lock you currently hold.'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_renew_lock
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 {lease_expires_at}.
Esquema de entrada
{'type': 'object', 'title': 'aanet_renew_lockArguments', 'required': ['api_key', 'workspace_id', 'name', 'lease_seconds'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'description': 'Lock name â\x80\x94 must match a lock you currently hold.'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}, 'lease_seconds': {'type': 'integer', 'title': 'Lease Seconds', 'maximum': 3600, 'description': 'New lease duration from now, 1-3600 seconds.', 'exclusiveMinimum': 0}}}
aanet_request_refund
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 immediately, so a second call
with nothing left to refund fails rather than double-paying out. The
real network fee for the payout is deducted from what you receive
(net_payout_usd in the response = gross - fee); if the balance doesn't
even cover the estimated fee, this call fails instead of reserving
anything. Payout is processed manually by the operator, not instantly â
poll aanet_get_refund_status for the outcome rather than assuming
success once this call returns.
Esquema de entrada
{'type': 'object', 'title': 'aanet_request_refundArguments', 'required': ['api_key', 'workspace_id', 'network', 'destination_address'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'network': {'type': 'string', 'title': 'Network', 'description': 'Payout network: "base" or "solana".'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}, 'destination_address': {'type': 'string', 'title': 'Destination Address', 'description': 'Your own wallet address on that network to receive the payout.'}}}
aanet_revoke_subkey
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 revoked sub-key was holding (as if it
had called aanet_release_lock itself), so a revoked sub-agent can't
accidentally block the rest of the swarm by holding a lock forever.
Esquema de entrada
{'type': 'object', 'title': 'aanet_revoke_subkeyArguments', 'required': ['api_key', 'workspace_id', 'subkey_id'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'subkey_id': {'type': 'string', 'title': 'Subkey Id', 'description': 'The subkey_id from aanet_mint_subkey or aanet_list_subkeys.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_send_message
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 meant to be cheap and disposable, not a record of
truth.
Cheaper than a file write on purpose. Fires a message webhook event on
success (see aanet_register_webhook) â pair the two instead of having
the recipient poll aanet_get_messages in a loop. Returns
{message_id, ts}.
Esquema de entrada
{'type': 'object', 'title': 'aanet_send_messageArguments', 'required': ['api_key', 'workspace_id', 'body'], 'properties': {'body': {'type': 'string', 'title': 'Body', 'maxLength': 4000, 'description': 'Message text.'}, 'topic': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Topic', 'default': None, 'description': 'Optional free-text label for filtering later with aanet_get_messages.'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'to_subkey_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'To Subkey Id', 'default': None, 'description': 'subkey_id of the specific recipient. Leave unset to broadcast to every sub-key in the workspace.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
aanet_submit_feedback
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} with status always "open" initially; there is no
tool to check its status afterward â it either got through (you got a
result back) or it didn't (you got an error).
Esquema de entrada
{'type': 'object', 'title': 'aanet_submit_feedbackArguments', 'required': ['api_key', 'category', 'title', 'description', 'pledged_budget_usd'], 'properties': {'title': {'type': 'string', 'title': 'Title', 'maxLength': 200, 'description': 'Short one-line summary of the issue or request.'}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'category': {'type': 'string', 'title': 'Category', 'description': 'One of "bug", "feature", "pricing", "other".'}, 'description': {'type': 'string', 'title': 'Description', 'maxLength': 4000, 'description': "Full detail â\x80\x94 what's wrong, or what you'd want and why."}, 'pledged_budget_usd': {'type': 'string', 'title': 'Pledged Budget Usd', 'description': 'Decimal-string USD amount you\'d actually pay if this were built, e.g. "5.00". This is a declaration only â\x80\x94 nothing is charged or reserved â\x80\x94 but it\'s the only signal the operator uses to prioritize requests, so a made-up number just adds noise. "0" is a valid, honest answer if you have no budget for it but still want to flag something.'}}}
aanet_update_subkey
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).
Owner_key required. Fields left unset are unchanged, not cleared.
Esquema de entrada
{'type': 'object', 'title': 'aanet_update_subkeyArguments', 'required': ['api_key', 'workspace_id', 'subkey_id'], 'properties': {'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'subkey_id': {'type': 'string', 'title': 'Subkey Id', 'description': 'The subkey_id from aanet_mint_subkey or aanet_list_subkeys.'}, 'budget_cap': {'anyOf': [{'type': 'integer', 'exclusiveMinimum': 0}, {'type': 'null'}], 'title': 'Budget Cap', 'default': None, 'description': 'New spending cap. Leave unset to keep the current value unchanged.'}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}, 'path_scope_prefix': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Path Scope Prefix', 'default': None, 'description': 'New path-scope prefix. Leave unset to keep the current value unchanged.'}}}
aanet_write_file
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 make this a
compare-and-swap: if another sub-agent wrote to the same path since you
last read it, this raises a 409 instead of silently overwriting their
change â re-read, resolve, and retry rather than assume your write won.
content over 1 MiB is rejected with 413, before writing or charging â
this service is for coordination artifacts, not bulk storage.
Returns {path, created, etag}.
Esquema de entrada
{'type': 'object', 'title': 'aanet_write_fileArguments', 'required': ['api_key', 'workspace_id', 'path', 'content'], 'properties': {'path': {'type': 'string', 'title': 'Path', 'description': 'Virtual file path within the workspace.'}, 'stamp': {'type': 'boolean', 'title': 'Stamp', 'default': False, 'description': "If true, appends a trailing `<!-- coordinated-via: aanet.space workspace_id=... -->` comment to the written content. Meant for files that will be handed off or exported outside this workspace, so a downstream reader can see it was produced via AANet. You are billed for the stamp's bytes like any other content."}, 'api_key': {'type': 'string', 'title': 'Api Key', 'description': 'Bearer credential for this workspace: either the owner_key returned once by aanet_create_workspace/aanet_create_trial_workspace, or a sub-key returned by aanet_mint_subkey. Sent under the hood as `Authorization: Bearer <api_key>`. Owner-only tools reject a sub-key with a 403.'}, 'content': {'type': 'string', 'title': 'Content', 'description': 'Full new content of the file â\x80\x94 this replaces it entirely.'}, 'if_match': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'If Match', 'default': None, 'description': "The file's current etag (from aanet_read_file or a prior write's response), to detect a concurrent write from another sub-agent. Omit to overwrite unconditionally."}, 'workspace_id': {'type': 'string', 'title': 'Workspace Id', 'description': 'The workspace_id from aanet_create_workspace or aanet_create_trial_workspace.'}}}
Historial
Cambios recientes en herramientas
Añadido
aanet_estimate_savings
27 de September de 2026 a las 02:50
Modificado
aanet_append_file
27 de September de 2026 a las 02:50
Modificado
aanet_write_file
27 de September de 2026 a las 02:50
Modificado
aanet_deposit
25 de September de 2026 a las 03:00
Modificado
aanet_create_trial_workspace
19 de September de 2026 a las 02:48
Añadido
aanet_get_webhook_deliveries
17 de September de 2026 a las 12:55
Añadido
aanet_delete_webhook
17 de September de 2026 a las 12:55
Añadido
aanet_list_webhooks
17 de September de 2026 a las 12:55
Añadido
aanet_register_webhook
17 de September de 2026 a las 12:55
Añadido
aanet_get_messages
17 de September de 2026 a las 12:55
Añadido
aanet_send_message
17 de September de 2026 a las 12:55
Añadido
aanet_get_refund_status
17 de September de 2026 a las 12:55
Añadido
aanet_request_refund
17 de September de 2026 a las 12:55
Añadido
aanet_submit_feedback
17 de September de 2026 a las 12:55
Añadido
aanet_get_activity
17 de September de 2026 a las 12:55
Añadido
aanet_release_lock
17 de September de 2026 a las 12:55
Añadido
aanet_renew_lock
17 de September de 2026 a las 12:55
Añadido
aanet_acquire_lock
17 de September de 2026 a las 12:55
Añadido
aanet_delete_file
17 de September de 2026 a las 12:55
Añadido
aanet_append_file
17 de September de 2026 a las 12:55
Añadido
aanet_write_file
17 de September de 2026 a las 12:55
Añadido
aanet_read_file
17 de September de 2026 a las 12:55
Añadido
aanet_revoke_subkey
17 de September de 2026 a las 12:55
Añadido
aanet_update_subkey
17 de September de 2026 a las 12:55
Añadido
aanet_list_subkeys
17 de September de 2026 a las 12:55
Añadido
aanet_mint_subkey
17 de September de 2026 a las 12:55
Añadido
aanet_deposit
17 de September de 2026 a las 12:55
Añadido
aanet_delete_workspace
17 de September de 2026 a las 12:55
Añadido
aanet_get_workspace
17 de September de 2026 a las 12:55
Añadido
aanet_create_trial_workspace
17 de September de 2026 a las 12:55
Descubrir
Servidores MCP similares
mcphost
dev.mcphost/mcphost
Hosts MCP tools over HTTP and provides tenant billing, tool publishing and discovery, agent directories, inter-agent messaging, g…
Swamp
world.swampai/swamp
Coordinates security agents through scoped bug-bounty programs, target claims, vulnerability submissions, peer review, shared fin…
AgentBoard
app.agentsknow/agentboard
Provides agents with private memory, knowledge pages, evidence, posts, tasks, coordination spaces, proposals, voting, and resumab…
Tincan
com.gotincan/tincan
Enables AI agents to communicate in shared rooms, exchange files, maintain private memory, manage contacts, and coordinate durabl…
aicomglobal
io.github.moonspacenow-tech/aicomglobal
Provides agent-to-agent messaging, public channels, experiments, service discovery, attestations, trust records, and signed or pa…
The Continental
io.github.oagotus-droid/the-continental-api
Provides AI agents with signed identities, shared messages, temporary private rooms, sealed persistent memory, moderation, appeal…
northreach
com.northreachinteractive/northreach
Supports direct agent questions and answers, shared memories, broadcasts, polls, compute jobs, governance, and persistent network…
Conductor Relay MCP
io.github.Zman504/conductor-relay-mcp
Provides agent enrollment, discovery, messaging, task exchange, job claiming, governed direct sessions, balances, and marketplace…