Contentu

API and MCP for agents

Your agent can read Contentu the way you do: the tools directory, remote jobs, the blog, events, challenges and course pages. With a key from your account it also reads your profile, your points, your progress and, if you have Contentu Lab+, member content. Everything is read only for now.

Free. Public data needs no key.

Connect over MCP

The Contentu MCP server uses stateless Streamable HTTP at this address:

https://www.contentu.co/api/agents/mcp

In Claude Code, without a key (public data only):

claude mcp add --transport http contentu https://www.contentu.co/api/agents/mcp

With a key from your account (public data plus what the key allows):

claude mcp add --transport http contentu https://www.contentu.co/api/agents/mcp \
  --header "Authorization: Bearer ctu_live_xxxxxxxx_
"

In other clients, use the same address and, for your account data, add the Authorization: Bearer header with your key.

Each operation in the table below is an MCP tool with the same name. The tool list depends on the key: without one you only see the public tools.

To connect your account from Claude.ai, ChatGPT or another client that uses OAuth, add a custom connector with this address. It will ask you to sign in to Contentu and choose which permissions to give it; disconnect it any time in My account → API.

https://www.contentu.co/api/agents/mcp/cuenta

Use the REST API

Every route hangs from this base and answers JSON:

https://www.contentu.co/api/agents/v1

Every route takes lang=es or lang=en. Lists take limit (up to 50) and return next_cursor: pass it as cursor for the next page.

Example with test data (response trimmed):

curl "https://www.contentu.co/api/agents/v1/tools?limit=1&lang=es"
{
  "data": [
    {
      "slug": "ejemplo-automatiza",
      "name": "Ejemplo Automatiza",
      "description": "Herramienta de ejemplo para automatizar flujos sin cĂłdigo.",
      "categories": [
        "automatizacion"
      ],
      "recommended_by_contentu": true,
      "sponsored": false,
      "affiliate_link": true,
      "disclosure": "Enlace de afiliado: si compras, Contentu recibe una comisiĂłn sin costo extra para ti",
      "visit_url": "https://automatiza.example/?ref=contentu",
      "url": "https://www.contentu.co/es/herramientas/ejemplo-automatiza"
    }
  ],
  "next_cursor": "eyJzIjoibGlz
"
}

With a key:

curl -H "Authorization: Bearer ctu_live_xxxxxxxx_
" "https://www.contentu.co/api/agents/v1/me/points"
{
  "points": 180,
  "points_this_month": 60,
  "level": 3,
  "level_name": "Creador",
  "next_level": {
    "name": "Colaborador",
    "points_missing": 120
  },
  "percent_to_next_level": 20
}

Operations

MCP toolREST routeAccess
list_toolsSearch toolsGET /toolsPublic
get_toolGet a toolGET /tools/{slug}Public
list_jobsSearch remote jobsGET /jobsPublic
get_jobGet a jobGET /jobs/{id}Public
list_postsList blog postsGET /postsPublic; member posts with content:read
get_postRead a blog postGET /posts/{slug}Public; member posts with content:read
list_eventsList eventsGET /eventsPublic
get_eventGet an eventGET /events/{slug}Public
list_challengesList challengesGET /challengesPublic
get_challengeGet a challengeGET /challenges/{slug}Public
list_coursesList coursesGET /coursesPublic
get_courseGet a courseGET /courses/{slug}Public
get_limitsGet usage limitsGET /limitsPublic
get_meGet my profile and planGET /meKey with profile:read
get_my_pointsGet my points and levelGET /me/pointsKey with points:read
get_my_learningGet my courses, challenges and progressGET /me/learningKey with learning:read
get_course_sessionRead a course sessionGET /courses/{slug}/sessions/{n}Key with content:read
list_saved_jobsList my saved jobsGET /me/saved-jobsKey with jobs:save
save_jobSave a jobPOST /me/saved-jobsKey with jobs:save
unsave_jobRemove a saved jobDELETE /me/saved-jobs/{job_id}Key with jobs:save
set_saved_job_statusSet the note of a saved jobPOST /me/saved-jobs/{id}/statusKey with jobs:save

Keys and permissions

Keys are created in My account. Each key has a name, the permissions you choose and an expiry date (30, 90 or 180 days). You can have up to 5 active keys and revoke them at any time.

  • profile:read: Your profile and your plan
  • learning:read: Your courses, challenges and progress
  • points:read: Your points and your level
  • content:read: Member content (only with Contentu Lab+)
  • jobs:save: Save openings and keep a note on each (only with Contentu Lab+)

A key looks like ctu_live_ followed by an id and a secret. It is shown once; Contentu only keeps a keyed hash of it.

The plan is not stored in the key: every request checks your account's current plan. If your membership ends, the key stops opening member content.

Create or revoke keys

Limits

  • Without a key: 30 requests per minute per IP address.
  • With a key: 120 requests per minute per key.
  • With a key, each IP address may fail the key check up to 30 times a minute (a wrong, expired or revoked key). After that it gets 429. Requests with a valid key do not count here.
  • Lists return up to 50 items per page. Long texts arrive trimmed with truncated: true and the link to the full page.
  • Over the limit you get 429 with a Retry-After header in seconds.

Errors

Over the REST API errors arrive as application/problem+json with a code that never changes and a request_id for support.

Over MCP they arrive as a result with isError, the same code and the request_id.

CodeStatusMeaning
invalid_request400The request is not valid
invalid_cursor400The cursor is not valid or no longer usable
unauthorized401A valid key is required
key_revoked401This key was revoked
key_expired401This key has expired
key_blocked403Access for this key is blocked
insufficient_scope403This key lacks a permission
membership_required403This content is for Contentu Lab+ members
admin_required403This key cannot administer Contentu now
origin_not_allowed403This origin may not call the gate
not_found404Not found
method_not_allowed405Method not allowed
invalid_state409The resource is not in a state that allows this
conflict409A resource with that identifier already exists
payload_too_large413The body is over the allowed size
unsupported_media_type415The body must be JSON
rate_limited429Too many requests; wait a moment
internal_error500Something failed on our side
not_available501This operation is not available yet
not_configured503The gate is not configured
temporarily_unavailable503Unavailable for a moment; retry

Rules of use

  • If you show the link of a tool whose affiliate_link is true, show its disclosure text next to it.
  • Applying to a job is free and happens on the employer's or the source's site. Credit the source of each job.
  • Member content is for the person who owns the key: do not publish or share it.
  • Do not use the API to send spam, scrape in bulk or work around the limits.

API and MCP terms of use

For machines