Contentful Graphql for AI agents

Contentful's GraphQL API queries content stored in Contentful directly, letting a developer pull exactly the fields a page needs in one request. Connect it once through Arc0, and your agent, or Claude, ChatGPT and Cursor, can use it through one MCP endpoint, limited to what each user approved.

Developer toolsAPI keyMCP + RESTcontentful.com
AUDIT LOG · CONTENTFUL GRAPHQLPOLICY: acme-support
09:41:07 · claude · u_8f2read
contentful_graphql.get_cma_token
Get CMA Token✓ allowed · 212ms
09:41:09 · claude · u_8f2write
contentful_graphql.graph_ql_content_api_persisted_query
GraphQL Content API Persisted Query✓ approved · approved by user
EVERY CONTENTFUL GRAPHQL CALL, ON THE RECORD
01 · USE CASES

What agents do in Contentful Graphql.

01

Query content with GraphQL

Run a GraphQL query against a space to pull exactly the content fields a page needs.

02

Fetch a persisted query

Run a saved persisted query instead of sending the full query text each time.

03

Get a management token

Get a CMA token before switching from reading content to editing it directly.

02 · ACTIONS

2 Contentful Graphql actions, graded by risk.

Every Contentful Graphql action is tagged read, write or destructive, so one policy covers the whole app and new actions inherit the right default.

read

1

Look things up. Allowed by default.

  • contentful_graphql.get_cma_token
    Get CMA Token

write

1

Create and change things. Allow, or ask the user first.

  • contentful_graphql.graph_ql_content_api_persisted_query
    GraphQL Content API Persisted Query

destructive

0

Delete, cancel or archive. Ask first, or deny outright.

  • No destructive actions.
03 · HOW IT WORKS

Contentful Graphql in three steps.

  1. 01Your users connect Contentful GraphqlThey add their Contentful Graphql api key on Arc0 Connect, under your brand. It goes straight into the vault.
  2. 02You set the rulesReads run, and writes like “graphQL Content API Persisted Query” can wait for the user to approve.
  3. 03Any agent can actYour agent calls Contentful Graphql through the Arc0 SDK or MCP, and so can Claude, ChatGPT and Cursor. Every call lands on the audit log.
POLICY.TS
await arc0.policies.set('contentful_graphql', {
  read: 'allow',
  write: 'ask',        // graph_ql_content_api_persisted_query
  destructive: 'deny',  
})

# Claude Code: the same connection, one URL
$ claude mcp add --transport http arc0 \
    https://mcp.arc0.ai/u/u_8f2
04 · AUTH AND DATA

How Contentful Graphql connects.

Users add their Contentful Graphql api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

The same Contentful Graphql connection serves your agent over MCP and your own backend over REST and the proxy, so a user connects once. How Arc0 handles credentials →

AUTH
API key
CREDENTIALS
Per-tenant encrypted vault
MODEL SEES
Results only, never credentials
AUDIT LOG
Every call, on every plan
05 · WORKS WITH

Use Contentful Graphql from any agent.

Claude
ChatGPT
Cursor
Codex
VS Code
OpenAI Agents SDK
Claude Agent SDK
Vercel AI SDK
Mastra
LangGraph
07 · FAQ

Contentful Graphql and Arc0, answered.

Q01

Can I use Contentful Graphql with Claude, ChatGPT or Cursor?

Yes. Connect Contentful Graphql to Arc0 once, then add your Arc0 MCP URL to Claude, ChatGPT, Cursor, Claude Code or any other remote-MCP client. Each assistant only gets the Contentful Graphql actions you allow.

Q02

How do users connect Contentful Graphql?

Users add their Contentful Graphql api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

Q03

Which Contentful Graphql actions can my agent take?

2 in total: 1 read, 1 write and 0 destructive, such as “graphQL Content API Persisted Query”. Your policies decide which of them each agent may call.

Q04

Can I make my agent read-only in Contentful Graphql?

Yes. Allow read actions and deny writes in the Contentful Graphql policy. Your agent can still look things up, and any write it attempts is blocked and logged.

Q05

Can my own backend call Contentful Graphql too?

Yes. The same Contentful Graphql connection is available over REST and through the Arc0 proxy, so your product and your agent share one connection per user.

Get started

Plug Contentful Graphql into your agent.

Your users connect Contentful Graphql once, under your brand. Your agent gets 2 actions behind your policies, with every call on the record.

Free to build · MCP + REST · Audit log on every plan