Server definition
- Hash
- sha256:c20d59336d42c7ca20394ead05dee93554c5091c03455e925da84c4dbc993139
- What it is
- What a remote MCP server returned when asked what it offers: 14 tools
The blob, as servednamed by its sha256
{
"instructions": "Documentation for JSONPad, a hosted JSON document store with a REST API at https://api.jsonpad.io.\n\nUse search_docs to find sections, read_doc to read them, get_api_endpoint for request and response contracts, get_sdk_method and get_cli_command for SDK signatures and CLI commands, lookup_error for error codes, and get_plan_limits for plan limits.\n\nBefore saving write rules or a flow, check them with check_write_rules or check_flow, which use the same engine as the API and cost nothing; try a single write with eval_write_rule. Validate schema sync documents with validate_sync_document, and token permissions with validate_token_permissions.\n\nPrefer the official SDKs (@basementuniverse/jsonpad-sdk and @basementuniverse/jsonpad-realtime-sdk) when writing JavaScript or TypeScript, and a schema sync document deployed with @basementuniverse/jsonpad-cli for lists, indexes, write rules and flows. Cite the jsonpad.io URLs you get back. Examples use <YOUR TOKEN> as a placeholder; never invent token values.\n\nThis server can't see anyone's data or call the API: use the JSONPad API MCP server for that.",
"tools": [
{
"description": "Compile a flow document (flows-v1) with the same engine the API uses, and run its tests (flow-tests-v1) against in-memory data. Returns diagnostics (with JSON pointers into the document), what the flow reads and writes, and why each failing test failed. Costs nothing and sees no data.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"flow": {
"anyOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "string"
}
],
"description": "The flow document"
},
"knownLists": {
"description": "Path names of lists that exist, so the flow using any other list is warned about",
"items": {
"type": "string"
},
"type": "array"
},
"tests": {
"anyOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "string"
}
],
"description": "The flow tests: a flow-tests-v1 document, optional"
}
},
"required": [
"flow"
],
"type": "object"
},
"name": "check_flow",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"diagnostics": {
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
}
},
"required": [
"ok",
"diagnostics"
],
"type": "object"
}
},
{
"description": "Compile a list's write rules with the same engine the API uses, and run their tests (a rules-tests-v1 document). Returns every diagnostic with its line and column, and for each failing test what it expected, what happened, and how each rule came out. Costs nothing and sees no data: lookups find the test document's items. Use it before saving rules.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"knownLists": {
"description": "Path names of lists that exist, so lookups into any other list are warned about, as the API does when rules are saved",
"items": {
"type": "string"
},
"type": "array"
},
"rules": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
],
"description": "The rule text, or its lines as an array (as in a schema sync document)"
},
"tests": {
"anyOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "string"
}
],
"description": "The rule tests: a rules-tests-v1 document ({ \"tests\": [...] }), optional"
}
},
"required": [
"rules"
],
"type": "object"
},
"name": "check_write_rules",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"diagnostics": {
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
}
},
"required": [
"ok",
"diagnostics"
],
"type": "object"
}
},
{
"description": "Check one write against a rule set, as the API would, and say whether it would be allowed, denied (403) or failed (400), which statement decided it, and (with trace) what every expression evaluated to. The write is shaped like a rule test case: action, identity, token, old, new, patch, merge, now. Costs nothing and sees no data.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"identities": {
"additionalProperties": {},
"description": "Named identities the write can refer to",
"type": "object"
},
"items": {
"additionalProperties": {},
"description": "Items for lookups to find: { \"<list>\": { \"<item id or alias>\": { \"data\": ... } } }",
"type": "object"
},
"rules": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
],
"description": "The rule text, or its lines as an array (as in a schema sync document)"
},
"trace": {
"default": false,
"description": "Include the value of every expression",
"type": "boolean"
},
"write": {
"additionalProperties": true,
"description": "The write to check",
"properties": {
"action": {
"enum": [
"create",
"update",
"delete",
"restore"
],
"type": "string"
},
"identity": {
"description": "The identity making the write: { \"id\": \"...\" }, a key into identities, or null"
},
"merge": {
"description": "A merge applied to old, instead of new"
},
"new": {
"description": "The item data after the write"
},
"now": {
"description": "The time of the write, ISO 8601",
"type": "string"
},
"old": {
"description": "The item data before the write (not for create)"
},
"patch": {
"description": "A JSON Patch applied to old, instead of new",
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
},
"token": {
"additionalProperties": {},
"description": "The API token, e.g. { \"id\": \"t1\", \"tags\": [\"writer\"] }",
"type": "object"
}
},
"required": [
"action"
],
"type": "object"
}
},
"required": [
"rules",
"write"
],
"type": "object"
},
"name": "eval_write_rule",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"ok": {
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "The full contract of one REST API endpoint: parameters, headers, request body, responses and examples, and the JavaScript SDK method that calls it. Find it by id (the docs page slug, e.g. \"item-restore\"), by method and path (templates or concrete paths both work: \"/lists/my-list/items/abc\"), or by a description.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "The endpoint id, from list_api_endpoints",
"type": "string"
},
"method": {
"description": "The HTTP method",
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"ANY"
],
"type": "string"
},
"path": {
"description": "The path, e.g. /lists/{listId}/items",
"type": "string"
},
"query": {
"description": "What the endpoint does, e.g. \"restore a deleted item\"",
"type": "string"
}
},
"type": "object"
},
"name": "get_api_endpoint",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"endpoint": {
"additionalProperties": {},
"type": "object"
}
},
"required": [
"endpoint"
],
"type": "object"
}
},
{
"description": "The usage, arguments and options of a jsonpad command line tool (@basementuniverse/jsonpad-cli) command, and whether it works offline. Find it by name (\"rules test\", \"jsonpad sync-schema --dry-run\") or by what it does.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"name": {
"description": "The command, e.g. \"sync-schema\" or \"jsonpad rules test\"",
"type": "string"
},
"query": {
"description": "What the command does, e.g. \"export items to a file\"",
"type": "string"
}
},
"type": "object"
},
"name": "get_cli_command",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"command": {
"additionalProperties": {},
"type": "object"
}
},
"required": [
"command"
],
"type": "object"
}
},
{
"description": "The limits of each public plan (Free, Indie, Pro, Scale): requests per month and minute, the minimum gap between requests, storage, item size, versions kept, tokens, identities, realtime connections, webhooks and flows. null means unlimited. Sizes are in bytes, rateLimit in milliseconds, prices in GBP.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "One limit, e.g. maxItemSize",
"enum": [
"maxRequestsPerMonth",
"overdraftPercent",
"maxRequestsPerMinute",
"rateLimit",
"maxStorageBytes",
"maxLists",
"maxItemsPerList",
"maxIndexesPerList",
"maxItemSize",
"maxItemVersions",
"maxTokens",
"maxIdentities",
"maxRealtimeConnections",
"maxWebhooks",
"maxFlows"
],
"type": "string"
},
"plan": {
"description": "One plan, by id or name, e.g. \"free\"",
"type": "string"
}
},
"type": "object"
},
"name": "get_plan_limits",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"plans": {
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
}
},
"required": [
"plans"
],
"type": "object"
}
},
{
"description": "The signature, description and example of a method in the JavaScript SDK (@basementuniverse/jsonpad-sdk) or the realtime SDK, and the REST endpoint it calls. Find it by name (\"restoreItem\") or by what it does.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"name": {
"description": "The method name, e.g. restoreItem",
"type": "string"
},
"package": {
"description": "Only one package",
"enum": [
"jsonpad-sdk",
"jsonpad-realtime-sdk"
],
"type": "string"
},
"query": {
"description": "What the method does, e.g. \"wait for an index to build\"",
"type": "string"
}
},
"type": "object"
},
"name": "get_sdk_method",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"method": {
"additionalProperties": {},
"type": "object"
}
},
"required": [
"method"
],
"type": "object"
}
},
{
"description": "List the REST API endpoints an API token can use, as method, path and title. Get one in full with get_api_endpoint.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"resource": {
"description": "Only one resource",
"enum": [
"lists",
"items",
"indexes",
"identities",
"tokens",
"flows",
"schema-sync"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_api_endpoints",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"endpoints": {
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
}
},
"required": [
"endpoints"
],
"type": "object"
}
},
{
"description": "List the documentation pages by section, with a description of each: the table of contents.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"section": {
"description": "Only list one section",
"enum": [
"guides",
"api-reference",
"lists",
"items",
"indexes",
"identities",
"tokens",
"flows",
"schema-sync",
"sdk",
"cli"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_docs",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"sections": {
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
}
},
"required": [
"sections"
],
"type": "object"
}
},
{
"description": "What a JSONPad API error code means, its HTTP status, and the guides that explain it. Give the numeric code (10013) or the name (QUOTA_EXCEEDED), as found in an error response's \"code\" and \"name\".",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"code": {
"description": "The numeric code, e.g. 10013",
"type": "integer"
},
"name": {
"description": "The name, e.g. QUOTA_EXCEEDED",
"type": "string"
}
},
"type": "object"
},
"name": "lookup_error",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"error": {
"additionalProperties": {},
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
},
{
"description": "Read a documentation page as markdown, or one section of it. Give a page slug (\"indexing\"), a /docs path, a jsonpad.io URL (with or without .md, and with an optional #anchor), \"sdk/jsonpad-sdk\", \"sdk/jsonpad-realtime-sdk\", \"cli/reference\" or \"cli/readme\". Long pages are cut at a section boundary; read on with the returned nextSection.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"maxChars": {
"default": 20000,
"description": "The most characters of markdown to return",
"maximum": 100000,
"minimum": 1000,
"type": "integer"
},
"page": {
"description": "The page: a slug, path or URL",
"minLength": 1,
"type": "string"
},
"section": {
"description": "A heading anchor (\"filtering-items\") or heading text; overrides a #anchor in page",
"type": "string"
}
},
"required": [
"page"
],
"type": "object"
},
"name": "read_doc",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"markdown": {
"type": "string"
},
"title": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"url",
"markdown",
"truncated"
],
"type": "object"
}
},
{
"description": "Search the JSONPad documentation, the JavaScript SDK references and the command line tool reference. Returns the best-matching sections with a snippet and their jsonpad.io URL; read one with read_doc. Exact identifiers work well: error codes and names, headers, SDK methods, CLI commands, $jsonpad-var variables, \"POST /lists/{listId}/items\".",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"default": 5,
"description": "How many results (1-10)",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "What to look for",
"maxLength": 200,
"minLength": 2,
"type": "string"
},
"section": {
"description": "Only search one section: guides, api-reference (every API reference section), lists, items, indexes, identities, tokens, flows, schema-sync, sdk or cli",
"enum": [
"guides",
"api-reference",
"lists",
"items",
"indexes",
"identities",
"tokens",
"flows",
"schema-sync",
"sdk",
"cli"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_docs",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"results": {
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
}
},
"required": [
"results"
],
"type": "object"
}
},
{
"description": "Check a schema sync document (sync-v1) as far as possible without an account: against the JSON schema the API uses, the API's rules for keys and indexes, and every rule set and flow in it with their tests. Documents that reference files (rulesFile, flowFile and their tests) are checked too if the files' contents are given in files. What a sync would change needs the account: the API server's plan_schema_sync, or jsonpad sync-schema --dry-run.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"document": {
"anyOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "string"
}
],
"description": "The schema sync document"
},
"files": {
"additionalProperties": {
"type": "string"
},
"description": "The contents of files the document references, keyed by the path written in the document, e.g. { \"rules/games.rules\": \"allow ...\" }",
"type": "object"
}
},
"required": [
"document"
],
"type": "object"
},
"name": "validate_sync_document",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"ok": {
"type": "boolean"
},
"problems": {
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
}
},
"required": [
"ok",
"problems"
],
"type": "object"
}
},
{
"description": "Check an API token's permission rules against the schema the API uses, say which rule shape a broken one was meant to be, and warn about valid rules that probably don't do what was meant (rule order, restore without view, sync-schema alone, allow \"*\").",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"permissions": {
"anyOf": [
{
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
},
{
"type": "string"
}
],
"description": "The permission rules, e.g. [{ \"mode\": \"allow\", \"action\": \"view\", \"resourceType\": \"item\", \"listIds\": [\"*\"], \"itemIds\": [\"*\"] }]"
}
},
"required": [
"permissions"
],
"type": "object"
},
"name": "validate_token_permissions",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"ok": {
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c20d59336d42c7ca20394ead05dee93554c5091c03455e925da84c4dbc993139 | sha256sum