Caisy MCP by usefulapi is an MCP server published by io.usefulapi, hosted at caisy.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 4 tools, including caisy_run_query, caisy_list_queries, caisy_list_documents, caisy_list_assets.
Run read-only GraphQL queries and list documents and media assets in Caisy.
4,161 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Run one read-only GraphQL query against this project's Caisy external API. Use it for any field, filter (where), sort, nested connection or localized value. Mutations and subscriptions are refused. Caisy: POST https://cloud.caisy.io/api/e/v4/<projectId>/graphql with header x-caisy-apikey.
| Parameter | Type | Description |
|---|---|---|
| query * | string | A GraphQL query, e.g. { allPage(first: 5) { edges { node { id slug } } } }. |
| variables | object | Optional GraphQL variables as a JSON object. |
{
"name": "caisy_run_query",
"title": "Run a read-only GraphQL query",
"description": "Run one read-only GraphQL query against this project's Caisy external API. Use it for any field, filter (where), sort, nested connection or localized value. Mutations and subscriptions are refused. Caisy: POST https://cloud.caisy.io/api/e/v4/<projectId>/graphql with header x-caisy-apikey.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "A GraphQL query, e.g. { allPage(first: 5) { edges { node { id slug } } } }."
},
"variables": {
"type": "object",
"description": "Optional GraphQL variables as a JSON object.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Run a read-only GraphQL query",
"readOnlyHint": true
}
}List the top-level read fields of this project's Caisy schema: one all<Blueprint> list query per non-unique blueprint, one single-entry query per unique blueprint, and the asset query. Call it first to learn the blueprint API ids.
No parameters.
{
"name": "caisy_list_queries",
"title": "List the project's read queries",
"description": "List the top-level read fields of this project's Caisy schema: one all<Blueprint> list query per non-unique blueprint, one single-entry query per unique blueprint, and the asset query. Call it first to learn the blueprint API ids.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List the project's read queries",
"readOnlyHint": true
}
}List document ids of one blueprint with Relay pagination (all<Blueprint>(first, after)). Returns ids only: call caisy_run_query for the fields you need. Unique blueprints have no list query: use caisy_run_query with the blueprint's single-entry field.
| Parameter | Type | Description |
|---|---|---|
| after | string | Cursor: pass pageInfo.endCursor from the previous page to get the next page. |
| first | integer | Documents per page (1–100, default set by Caisy). |
| blueprint * | string | The blueprint API id, e.g. Page (from caisy_list_queries). |
{
"name": "caisy_list_documents",
"title": "List documents of a blueprint",
"description": "List document ids of one blueprint with Relay pagination (all<Blueprint>(first, after)). Returns ids only: call caisy_run_query for the fields you need. Unique blueprints have no list query: use caisy_run_query with the blueprint's single-entry field.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"blueprint"
],
"properties": {
"after": {
"type": "string",
"maxLength": 2000,
"description": "Cursor: pass pageInfo.endCursor from the previous page to get the next page."
},
"first": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Documents per page (1–100, default set by Caisy)."
},
"blueprint": {
"type": "string",
"pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
"description": "The blueprint API id, e.g. Page (from caisy_list_queries)."
}
}
},
"annotations": {
"title": "List documents of a blueprint",
"readOnlyHint": true
}
}List media assets (title and source URL) of this project, with Relay pagination. Use the cursor from pageInfo.endCursor to read further.
| Parameter | Type | Description |
|---|---|---|
| after | string | Cursor: pass pageInfo.endCursor from the previous page to get the next page. |
| first | integer | Documents per page (1–100, default set by Caisy). |
{
"name": "caisy_list_assets",
"title": "List media assets",
"description": "List media assets (title and source URL) of this project, with Relay pagination. Use the cursor from pageInfo.endCursor to read further.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"after": {
"type": "string",
"maxLength": 2000,
"description": "Cursor: pass pageInfo.endCursor from the previous page to get the next page."
},
"first": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Documents per page (1–100, default set by Caisy)."
}
}
},
"annotations": {
"title": "List media assets",
"readOnlyHint": true
}
}Tools for Caisy, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which pages in our Caisy project are not published yet?"; "List the blueprints in our Caisy project and how many documents each has."; "Find the page with slug pricing and show its title and last updated date.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Caisy data. Free plan: 50 tool calls per month. Run caisy_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run caisy_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run caisy_upgrade without a plan: it returns both plans, each with a payment link for the user to open. caisy_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.