Integration

Are.na integration

Are.na is a visual research and knowledge-collection platform built from channels (collections) and blocks (text, images, links, attachments, embeds). Read channels, blocks, users and groups and their contents, followers and connections; create, update and delete channels and connections, create and update blocks, add and delete comments; batch-import blocks; read your feed and notifications; manage groups, members and invitations; and search Are.na (search requires a Premium plan). The OAuth token exchange, the presigned file-upload route and the spec and health routes are not exposed. Authentication is a personal access token (are.na settings, Personal access tokens) or an OAuth2 access token, sent as Authorization: Bearer; most reads also work on public content, and writes need a token with the write scope.

Connect Are.na How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Are.na.Built from the 49 Are.na tools below, on the connection you add once.

What you can do with Are.na

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Connection, 7 operations

create_connectionCreate connectionPOSTConnects an existing block or channel to up to 20 more channels and returns the created connections. Pass channels or channel_ids, not both. Needs a write-scope token.
delete_connectionDelete connectionDELETERemoves a block or channel from a channel by deleting the connection. The block/channel itself is not deleted - it may still exist in other channels. Authentication required.
get_block_connectionsGet block connectionsGETReturns paginated list of channels where this block appears. This shows all channels that contain this block, respecting visibility rules and user permissions.
get_channel_connectionsGet channel connectionsGETReturns paginated list of channels where this channel appears. This shows all channels that contain this channel, respecting visibility rules and user permissions.
get_connectionGet connectionGETReturns a connection (a block or channel placed in a channel), including whether you can remove it. The connection id is the connection.id on each item of get_channel_contents.
move_connectionMove connectionPOSTMoves a connection to a new position within its channel. Requires sort permission on the channel. Authentication required.
update_connectionUpdate connectionPUTUpdates a connection's metadata. Uses merge semantics: new keys are added, existing keys are updated, keys set to null are removed. Authentication required.

Group, 7 operations

create_groupCreate groupPOSTCreates a new group owned by the authenticated user. Authentication required.
delete_groupDelete groupDELETEPermanently deletes a group; it cannot be restored. Needs a write-scope token and permission to manage the group.
get_groupGet groupGETReturns detailed information about a specific group by its slug. Includes group profile, description, owner, counts, and permissions.
get_user_groupsGet user groupsGETReturns paginated list of groups the user belongs to (as owner or member). When authenticated as the target user, includes private groups.
join_groupJoin groupPOSTJoins a group as the authenticated user, using the group's invite code (from get_group_invite or create_group_invite). Idempotent: an existing owner or member gets their member entry back.
leave_groupLeave groupDELETERemoves the authenticated user from the group. Idempotent: returns `204` whether or not the user was a member. Authentication required.
update_groupUpdate groupPUTUpdates an existing group. Only provided fields are updated. Authentication required.

Channel, 4 operations

create_channelCreate channelPOSTCreates a channel owned by you or a group you belong to. visibility defaults to closed (anyone can view, only collaborators add); pass private to hide it. Needs a write-scope token.
delete_channelDelete channelDELETEPermanently deletes a channel and the connections it holds; it cannot be restored. Needs a write-scope token and permission to delete the channel.
get_channelGet channelGETReturns detailed information about a specific channel by its ID or slug. Respects visibility rules and user permissions.
update_channelUpdate channelPUTUpdates an existing channel. Only provided fields are updated. Updating the owner requires permission to assign authorship to the target user or group. Authentication required.

Content, 4 operations

get_channel_contentsGet channel contentsGETReturns paginated contents (blocks and channels) from a channel. Respects visibility rules and user permissions.
get_group_contentsGet group contentsGETReturns paginated contents (blocks and channels) created by a group. Uses the search API to find all content added by the specified group.
get_user_contentsGet user contentsGETReturns paginated contents (blocks and channels) created by a user. Uses the search API to find all content added by the specified user.
searchSearchGETPremium only. Searches blocks, channels, users and groups by text; filter by type, scope (all, my, following), user_id, group_id, channel_id, file ext or metadata, and sort. Use query=* to match everything.

Block, 3 operations

create_blockCreate blockPOSTCreates a block and connects it to up to 20 channels. value is a URL (an Image, Link or Embed block, type inferred) or text (a Text block). Pass channels or channel_ids, not both. Needs a write-scope token.
get_blockGet blockGETReturns detailed information about a specific block by its ID. Respects visibility rules and user permissions.
update_blockUpdate blockPUTUpdates a block's metadata. Only the block owner can update it. Authentication required.

Comment, 3 operations

create_block_commentCreate block commentPOSTCreates a new comment on a block. Authentication required. You can mention users in the comment body using `@username` syntax.
delete_commentDelete commentDELETEDeletes a comment. Only the comment author can delete their comments. Authentication required.
get_block_commentsGet block commentsGETReturns paginated list of comments on this block. Comments are ordered by creation date (ascending by default, oldest first).

Follower, 3 operations

get_channel_followersGet channel followersGETReturns paginated list of users who follow this channel. All followers are users.
get_group_followersGet group followersGETReturns paginated list of users who follow this group. All followers are users.
get_user_followersGet user followersGETReturns paginated list of users who follow this user. All followers are users.

Invitation, 3 operations

create_group_invitationCreate group invitationPOSTAdds or invites someone to a group by user_id or email. A user who follows you is added at once; otherwise an invitation email is sent. Read outcome: added, invited, invitation_pending or already_member.
get_group_invitationsGet group invitationsGETLists a group's pending membership invitations, newest first. Only users who can manage the group's invitations (typically the owner and members) may list them. Create one with create_group_invitation.
revoke_group_invitationRevoke group invitationDELETERevokes a pending group invitation so it can no longer be accepted. Allowed for its creator or anyone who can manage the group's invitations. Fails with 422 if it is no longer pending.

Invite, 3 operations

create_group_inviteCreate group invitePOSTCreates the group's shareable invite code if it does not exist, or returns the existing one. Only users who can manage the group may create or view the reusable invite code.
delete_group_inviteDelete group inviteDELETEDeletes the group's shareable invite code. Idempotent: returns `204` whether or not an invite code existed. Authentication required.
get_group_inviteGet group inviteGETReturns the group's shareable invite code and public invite URL. Only users who can manage the group may view the reusable invite code. Authentication required.

Member, 3 operations

get_group_membersGet group membersGETLists a group's members, page by page. The owner is always first on page 1 with role owner, then collaborators newest first with their role. Non-managers only see collaborators with confirmed accounts.
remove_group_memberRemove group memberDELETERemoves a user from a group. Authentication required.
update_group_memberUpdate group memberPATCHUpdates a group member's role. Only group admins and the group owner may change roles. The owner has no membership record and cannot be updated through this endpoint.

Notification, 3 operations

get_my_notificationsGet my notificationsGETReturns the authenticated user's notifications feed. Each notification includes read state for the current user.
mark_all_my_notifications_readMark all my notifications readPOSTClears the authenticated user's unread notification state and returns the new unread count.
mark_my_notification_readMark my notification readPOSTMarks one notification activity as read for the authenticated user and returns the updated notification plus the new unread count.

Batch, 2 operations

batch_create_blocksBatch create blocksPOSTPremium only. Queues up to 50 blocks for background creation in up to 20 channels and returns a batch_id at once; read progress and the created block ids with get_batch_status (kept 24 hours).
get_batch_statusGet batch statusGETPremium only. Returns a batch job's status (pending, processing, completed or failed), its counts, the created block ids (successful) and per-block errors (failed). Results are kept 24 hours.

User, 2 operations

get_current_userGet current userGETReturns the currently authenticated user's profile, including the token holder's `email` address.
get_userGet userGETReturns detailed information about a specific user by their slug. Includes user profile, bio, and counts.

Feed, 1 operation

get_my_feedGet my feedGETReturns the authenticated user's primary activity feed. This feed is personalized and requires authentication.

Following, 1 operation

get_user_followingGet user followingGETReturns paginated list of users, channels, and groups that this user follows. Can be filtered by type to return only specific followable types.

Use Are.na from Claude Code, Cursor or Codex

Connect Are.na in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Are.na operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Are.na

Create your workspace
Sign up free. Nothing to install.
Connect Are.na once
Add your Are.na connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.