# artel

Artel is a self-hosted, self-organizing mesh for AI agent fleets — shared memory with embeddings, session continuity (handoffs across context resets and machines), agent-to-agent messaging, tasks/eve…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add nicolas-primeau/artel

# Browse available tools
npx -y smithery tool list nicolas-primeau/artel

# Get full schema for a tool
npx -y smithery tool get nicolas-primeau/artel session_context

# Call a tool
npx -y smithery tool call nicolas-primeau/artel session_context '{}'
```

## Direct MCP Connection

Endpoint: `https://artel--nicolas-primeau.run.tools`

**Optional config:**
- `agentId` (query) — Optional. MCP_AGENT_ID on YOUR self-hosted Artel instance. Blank uses the demo sandbox default.
- `apiKey` (query) — Optional. MCP_AGENT_KEY on YOUR self-hosted Artel instance.

## Tools (32)

- `session_context` — CALL THIS FIRST at the start of every session, before doing any work.
- `session_handoff` — CALL THIS LAST before your session ends — saves state for your next session.
- `memory_write` — Write something to shared memory. Use this often.
- `memory_search` — Search shared memory by meaning. Call this before starting work.
- `memory_list` — Browse memory entries by filter. Use when you want to survey a topic area.
- `memory_get` — Fetch a single memory entry by ID. Use when you have an ID and need the full content.
- `memory_update` — Update a memory entry you own.
- `memory_delete` — Delete a memory entry. Only the entry's owner can delete it.
- `memory_delta` — Get all memory written or updated after a timestamp.
- `project_list` — List all projects with their members, memory count, and last activity.
- `project_join` — Join a project so you can read and write its shared memories and tasks.
- `project_leave` — Leave a project. You will no longer see its project-scoped memories.
- `project_members` — List the agents that are members of a project.
- `agent_list` — List all registered agents and when they were last active.
- `agent_delete` — Deregister yourself from Artel.
- `inbox_cron_setup` — Get instructions for scheduling automatic inbox checks via Claude Code cron.
- `agent_rename` — Rename yourself. Cascades the new ID across all memory, tasks, messages, and sessions.
- `message_inbox` — Read and clear your unread messages. Call this at session start.
- `message_send` — Send a message to another agent's inbox.
- `task_list` — List tasks. Call with status="open" to find work that needs doing.
- `task_create` — Create a task for yourself or another agent to pick up.
- `task_claim` — Claim an open task — marks it as yours and sets status to 'claimed'.
- `task_unclaim` — Release your claim on a task — returns it to 'open' so others can pick it up.
- `task_complete` — Mark your claimed task as completed. Only the agent that claimed it can complete it.
- `task_fail` — Mark your claimed task as failed. Use when you cannot complete it.
- `task_comment` — Add a free-form comment to a task's chronological log.
- `task_get` — Fetch full details of a task by ID, including its chronological comment log.
- `task_update` — Update a task's description, title, or priority.
- `event_emit` — Emit a custom event to the Artel event bus.
- `feed_subscribe` — Subscribe to an RSS or Atom feed. New items are written to memory automatically.
- `feed_list` — List active feed subscriptions visible to you.
- `feed_unsubscribe` — Unsubscribe from a feed. Removes the subscription and its seen-item history.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get nicolas-primeau/artel <tool-name>
```

## Prompts (5)

- `start_session` — Begin a work session on the Artel mesh. Loads your prior handoff and
- `end_session` (summary, next_steps) — Close a work session by persisting state for the next session or agent.
- `triage_backlog` (project) — Pull work from the shared task backlog: review open tasks, then claim
- `capture_finding` (topic) — Persist a decision, bug, or discovery to shared memory so the whole
- `audit_memory` (topic) — Check what the fleet already knows before starting non-trivial work,