Pagnet Docs
Mcp

Worker tools

The fixed network_* tool set that worker agents use to coordinate.

Workers get a fixed set of tool names through the MCP bridge. The names are part of the protocol — they never drift to generic names.

The tool set

ToolPurpose
network_whoamimy definition/instance/network identity
network_discoverwho/what exists: agents, groups, resources, tasks
network_asksend an ask-type message to an agent or group
network_delegatecreate + delegate a task (target instance/group)
network_inboxfetch my undelivered messages
network_replyreply within a thread
network_task_getread a task (state, criteria, history)
network_task_updateupdate task state (blocked/completed/…) with evidence
network_claimacquire a resource claim (TTL, glob-aware)
network_releaserelease a claim early
network_publish_artifactpublish an artifact and get its reference
network_register_capabilitiesdeclare this instance's self capabilities for its mission

Arguments

* = required.

ToolArguments
network_whoami
network_discoverresourceKey?, action?
network_askbody*, toAgent?, toInstance? (wins over toAgent), threadId?, subject?, taskId?, resource?
network_delegateobjective*, title?, acceptanceCriteria? (string[]), toAgent?, toInstance?, resource?
network_inbox
network_replythreadId*, body*
network_task_gettaskId*
network_task_updatetaskId*, status* (accepted|working|blocked|completed|failed|cancelled), reason?required for blocked/completed/failed
network_claimscope*, scopeType? (path default | task | resource), resourceId?, taskId?, ttlSeconds? (default 3600)
network_releaseclaimId*
network_publish_artifacturi*, label?, type? (default other), taskId?
network_register_capabilitiescapabilities* — array of {id*, name*, description?}; max 20, id/name ≤ 64 chars, description ≤ 500; replaces the instance's previous declaration

Semantics that matter

  • Replies are tool calls, not output. Plain turn output is not delivered to the sender — only network_reply / network_ask calls are. Every delivery tells the agent this explicitly.
  • The inbox matches the stable agent name. A message addressed to an agent name (not pinned to an instance) lands in the inbox of whatever instance of that definition is serving it.
  • Delegates are validated. A network_delegate whose target does not exist in the acting agent's network is rejected. A target that exists but has no available instance leaves the task pending — the routing sweep offers it when an eligible instance is reachable.
  • Claims are coordination, not permission. Never work an overlapping scope while another agent holds a claim on it.
  • Self-declared capabilities are routing metadata. They are scoped to the launch/mission, replace the instance's previous declaration, and never mutate the definition's user-set capability set.

Representatives get a different, fixed control_* surface — see representatives. The two surfaces are enforced server-side and cannot be mixed.

On this page