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/mcpIn Claude Code, without a key (public data only):
claude mcp add --transport http contentu https://www.contentu.co/api/agents/mcpWith 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/cuentaUse the REST API
Every route hangs from this base and answers JSON:
https://www.contentu.co/api/agents/v1Every 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 tool | REST route | Access |
|---|---|---|
list_toolsSearch tools | GET /tools | Public |
get_toolGet a tool | GET /tools/{slug} | Public |
list_jobsSearch remote jobs | GET /jobs | Public |
get_jobGet a job | GET /jobs/{id} | Public |
list_postsList blog posts | GET /posts | Public; member posts with content:read |
get_postRead a blog post | GET /posts/{slug} | Public; member posts with content:read |
list_eventsList events | GET /events | Public |
get_eventGet an event | GET /events/{slug} | Public |
list_challengesList challenges | GET /challenges | Public |
get_challengeGet a challenge | GET /challenges/{slug} | Public |
list_coursesList courses | GET /courses | Public |
get_courseGet a course | GET /courses/{slug} | Public |
get_limitsGet usage limits | GET /limits | Public |
get_meGet my profile and plan | GET /me | Key with profile:read |
get_my_pointsGet my points and level | GET /me/points | Key with points:read |
get_my_learningGet my courses, challenges and progress | GET /me/learning | Key with learning:read |
get_course_sessionRead a course session | GET /courses/{slug}/sessions/{n} | Key with content:read |
list_saved_jobsList my saved jobs | GET /me/saved-jobs | Key with jobs:save |
save_jobSave a job | POST /me/saved-jobs | Key with jobs:save |
unsave_jobRemove a saved job | DELETE /me/saved-jobs/{job_id} | Key with jobs:save |
set_saved_job_statusSet the note of a saved job | POST /me/saved-jobs/{id}/status | Key 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 planlearning:read: Your courses, challenges and progresspoints:read: Your points and your levelcontent: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.
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.
| Code | Status | Meaning |
|---|---|---|
invalid_request | 400 | The request is not valid |
invalid_cursor | 400 | The cursor is not valid or no longer usable |
unauthorized | 401 | A valid key is required |
key_revoked | 401 | This key was revoked |
key_expired | 401 | This key has expired |
key_blocked | 403 | Access for this key is blocked |
insufficient_scope | 403 | This key lacks a permission |
membership_required | 403 | This content is for Contentu Lab+ members |
admin_required | 403 | This key cannot administer Contentu now |
origin_not_allowed | 403 | This origin may not call the gate |
not_found | 404 | Not found |
method_not_allowed | 405 | Method not allowed |
invalid_state | 409 | The resource is not in a state that allows this |
conflict | 409 | A resource with that identifier already exists |
payload_too_large | 413 | The body is over the allowed size |
unsupported_media_type | 415 | The body must be JSON |
rate_limited | 429 | Too many requests; wait a moment |
internal_error | 500 | Something failed on our side |
not_available | 501 | This operation is not available yet |
not_configured | 503 | The gate is not configured |
temporarily_unavailable | 503 | Unavailable 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.