# Are.na — how to use (mcp.ai)

Connect your Are.na account and use 10 tools for bookmarks straight from your AI agent. Connect with your own API key. Are.na is a platform for collecting, organizing, and connecting ideas, images, links, and other creative research.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_arena?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `arena_add_to_channels`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/arena`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/arena/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/arena/add/to/channels` — Add an existing Are.na block or channel to one or more target channels without duplicating the underlying resource.
  - body: { position?: integer, channel_ids: integer|string[], connectable_id: integer, connectable_type: string }
- `POST https://api.mcp.ai/api/arena/create/channel` — Create a user-owned Are.na channel, closed by default, and return its stable numeric ID and generated slug.
  - body: { title: string, metadata?: object, visibility?: string, description?: string }
- `POST https://api.mcp.ai/api/arena/delete/channel` — Permanently delete one Are.na channel the authenticated user is allowed to destroy. This cannot be undone.
  - body: { channel_id: string }
- `POST https://api.mcp.ai/api/arena/get/block` — Get the details of one Are.na block by ID, including its subtype, content, source, creator, and metadata.
  - body: { block_id: integer }
- `POST https://api.mcp.ai/api/arena/get/channel` — Get an Are.na channel by numeric ID or slug, including visibility, counts, owner, and the current user's permissions.
  - body: { channel_id: string }
- `POST https://api.mcp.ai/api/arena/get/current/user` — Return the identity and account details for the authenticated Are.na user.
- `POST https://api.mcp.ai/api/arena/get/my/feed` — Return one page of the authenticated user's personalized Are.na activity feed, newest first. Call again with next_cursor only when another page is needed.
  - body: { limit?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/arena/list/channel/contents` — Return one page of blocks and nested channels from an Are.na channel, with optional sorting and contributor filtering.
  - body: { sort?: string, user_id?: integer, per_page?: integer, channel_id: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/arena/remove/from/channel` — Remove one block or nested channel placement from an Are.na channel. This deletes only the connection; the underlying block or channel remains intact and may still exist in other channels.
  - body: { connection_id: integer }
- `POST https://api.mcp.ai/api/arena/update/channel` — Update selected fields of an Are.na channel the authenticated user can edit. Fields omitted from the request remain unchanged.
  - body: { title?: string, metadata?: object, channel_id: string, visibility?: string, description?: string }

## Example prompts
- "What can I do in Are.na?"
- "Show me a summary of my Are.na account"

## More
- Page: https://mcp.ai/arena
- Agent spec (llms.txt): https://mcp.ai/arena/llms.txt
- Postman collection: https://mcp.ai/arena/postman.json