Skip to main content
Paperclip is the primary orchestration agent in Jarvis. It acts in a CTO role — it receives your goal, plans how to accomplish it, and delegates work to the right specialist agents. For most tasks, Paperclip is where you start.

​
What Paperclip handles best

Paperclip excels at tasks that require planning, tool use, or cross-agent coordination:
  • Multi-step workflows — tasks with dependencies and ordered execution
  • Infrastructure operations — provisioning, configuration, deployment
  • Tool-heavy tasks — anything that needs MCP tools like ServiceNow, file systems, or custom integrations
  • Delegation and assembly — breaking a broad goal into sub-tasks and assembling the results
For pure communication tasks, consider Hermes. For code-specific work, Claude Code may be more direct.

​
Typical Paperclip workflow

1

Submit your task

Send a natural-language description of your goal to Paperclip via the API or n8n.
curl -X POST https://your-jarvis-host/agents/invoke \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "paperclip",
    "task": "Check disk usage on all brain mesh nodes and open a ServiceNow ticket for any node above 80%."
  }'
2

Paperclip plans the work

Paperclip breaks your task into sub-tasks: query each node, evaluate disk usage, and conditionally open tickets.
3

Sub-agents execute

Engineer sub-agents run the node queries using MCP tools. If thresholds are exceeded, the ServiceNow tool opens tickets automatically.
4

Results are assembled

Paperclip collects results from each sub-agent and returns a summary — node status, tickets opened, and any errors.

​
Invoke Paperclip

​
Via API

curl -X POST https://your-jarvis-host/agents/invoke \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "paperclip",
    "task": "Your task description here."
  }'

​
With options

{
  "agent": "paperclip",
  "task": "Deploy the latest Docker image for the monitoring stack.",
  "options": {
    "timeout": 120,
    "tools": ["docker", "filesystem"]
  }
}
See the agents API reference for the full request schema.

​
Example task delegation

The following example delegates a documentation-plus-deployment task. Paperclip routes the engineering steps to an Engineer sub-agent and the write-up to a Writer sub-agent: 
{
  "agent": "paperclip",
  "task": "Pull the latest config from the repo, apply it to jarvis-brain, then write a one-paragraph summary of what changed."
}
Paperclip returns both the deployment result and the summary in a single response.

​
Supported MCP tools

Paperclip can invoke any tool registered in your MCP ecosystem. Commonly used tools include:
  • Filesystem — read, write, and traverse files on brain mesh nodes
  • ServiceNow — create, update, and query incidents and change requests
  • Docker — manage containers and compose stacks
  • HTTP — make arbitrary API calls to internal or external services
  • Jarvis custom tools — platform-specific tools for node management and model control
For the full tool list, see MCP tools.