MCP Server
The Archive MCP server lets compatible AI assistants — Claude, ChatGPT, Cursor, Claude Code, VS Code, and others — call the Archive API natively, in plain language, without writing GraphQL by hand. This page is the running catalog of what the MCP server can do: every tool it exposes, grouped by area.
Setup lives on two pages: Creating a Custom Connector is the one-time step for Claude and ChatGPT, since Archive isn’t in either directory yet; Connecting an Agent is the per-client sign-in — Claude, Claude Code, ChatGPT, and config-file clients — plus the read-only vs. full-access choice. This page is the capability catalog. Server URL:
https://app.archive.com/api/v2/mcp.
Not a developer? Using the Archive MCP Server in our Help Center covers the same ground without the GraphQL — what you can ask for in plain language, animated walkthroughs of connecting each assistant, how to manage or revoke connections, and which plans include it. If you connected before write actions shipped, it also explains the disconnect-and-reconnect needed to grant write access.
The connector groups its tools into read-only (29) and write/delete (24), each settable to Always allow, Ask, or Never in your client.
Every tool is workspace-scoped — it acts on the workspace you’re connected to, or the one you name.
MCP calls spend the same credit budget as the GraphQL API. There is no separate MCP allowance: each tool call maps to a query and costs what that query costs, drawn from your workspace’s single budget. So an agent working through a long task competes with your own integrations for the same credits. A tool call that lists items costs about what an
itemspage costs; one that filters creators by custom attributes costs about seven times more. See Rate Limiting for the per-plan numbers and the full cost table.
Read tools
Available today. These mirror the API Reference queries — anything you can read over GraphQL, an agent can read through the MCP.
Workspace & schema
| Tool | What it does |
|---|---|
getWorkspaces | List the workspaces you can access. |
getWorkspace | One workspace’s tracked hashtags, mentions, keywords, and connected integrations. |
getCustomAttributeSchemas | Custom-attribute definitions for ITEM or CREATOR — used to interpret customAttributes and to build attribute filters. |
getFilterPresets | Saved filter presets (Content Views + Collections) with their ids. |
Content & media
| Tool | What it does |
|---|---|
searchItems | Search archived content (Instagram, TikTok, YouTube) with the full filter set, sorting, and presetId. |
getMediaContents | Media files (images/videos) for items — or for tracked Competitor Insights items. |
getTranscriptions | Transcripts for the media attached to items. |
getItemIdsByUrl | Resolve post URLs to Archive item ids. |
getEngagementHistory | The engagement-snapshot timeline (likes, comments, views, EMV, …) for a single item. |
Creators & social profiles
| Tool | What it does |
|---|---|
searchCreators | Search creators tracked in the workspace, with custom-attribute and location filters. |
getCreator | One creator by id, with custom attributes. |
getSocialProfile | One social profile by id, or by handle + provider. With fallback: true it fetches live from the platform even if the profile isn’t archived yet. |
getSocialProfiles | Page through every social profile in the workspace, with totalCount and cursor pagination. Narrow by a saved view with preset_id. |
Views & collections
| Tool | What it does |
|---|---|
getContentViews / getContentView | Saved media-deck views (list / single). Pair with searchItems(preset_id:). |
getSocialProfileViews / getSocialProfileView | Saved Social Profile views. |
getCreatorViews / getCreatorView | Saved Creator views. |
getViewGroups / getViewGroup | Sidebar view groups and their member views. |
getCollections / getCollection | Collections (saved tag sets) and their item counts. |
Campaigns, competitors & operations
| Tool | What it does |
|---|---|
getCampaigns | List campaigns in the workspace. |
getCompetitorBrands / getCompetitorBrand | Competitor Insights brands tracked on the workspace (list / single). |
getCompetitorBrandItems | Content captured for a competitor brand, within a date window. |
getOperations / getOperation | Track async operations (e.g. a bulk engagement refresh) and their status. |
Using with AI:
“List the workspaces I can access, then show me this month’s top posts in Anne Enterprise.” “Pull the current follower count for @thehandle on Instagram.” “How is engagement evolving on this post over time?”
Write tools
An agent can act on Archive, not just read from it. Every write runs behind a per-call approval in the AI client (the assistant asks before it changes anything), and deletes only remove the saved view / collection / group — never the underlying content, creators, or media.
Collections
| Tool | What it does |
|---|---|
createCollection / updateCollection / deleteCollection | Create, rename, or delete a Collection (saved tag set). |
addItemToCollections / removeItemFromCollections | Tag or untag an item. |
Views
| Tool | What it does |
|---|---|
createContentView / updateContentView / deleteContentView | Manage Content Views (updates are partial). |
createSocialProfileView / updateSocialProfileView / deleteSocialProfileView | Manage Social Profile Views. |
createCreatorView / updateCreatorView / deleteCreatorView | Manage Creator Views. (Creator Views narrow by customAttributeConditions, not by the filters blob — see Creators → Creator Views.) |
View groups
| Tool | What it does |
|---|---|
createViewGroup / updateViewGroup / deleteViewGroup | Create, rename, or delete a sidebar view group. |
moveContentViewToGroup / moveSocialProfileViewToGroup / moveCreatorViewToGroup | Move a view into or out of a group. |
moveCollectionToGroup | Move a Collection into or out of a group — the API equivalent of the UI’s right-click Add Collection to Group. Collections are grouped by the same mechanism as views, but take a collection_id, not a view_id. |
reorderViewsInGroup | Reorder the views inside a group. |
Items
| Tool | What it does |
|---|---|
uploadItemFromUrl | Import a public post by URL (async — the item appears a few minutes later). |
refetchEngagementBulk | Queue a bulk engagement-metrics refresh for a set of items; track it with getOperation. Spends credits and requires a feature flag. |
Using with AI:
“Save my current search as a Content View called ‘Q3 Micro-Influencers’.” “Add these posts to a new collection called ‘Holiday UGC’.”
Notes
- Read + write. The connector exposes up to 53 tools — 29 read and 24 write. You’ll only see the tools your organization has granted access to, and each one can be set to Always allow, Ask, or Never in your client’s connector settings.
- Errors are returned as text, not exceptions — e.g. a rate-limited call comes back as
Rate limit exceeded. Retry after N seconds., and a domain rejection on a write comes back inuserErrors(the write did not happen). Most MCP clients will retry after the stated wait on their own; if yours doesn’t, that message is the one to handle. - This catalog is kept in sync with the live server. If the MCP gains or renames a tool, this page is updated alongside it.