MCP Server

Koskamo

com.koskamo/koskamo
Knowledge & Documentation Public & reachable MCP 2025-11-25

What this MCP does

Retrieves cited passages from versioned public datasets and supports owner-approved proposals, revisions, deletions, and history tracking.

koskamo_decide_revision
Approve or reject a revision
Approve or reject a pending revision. Requires the dataset owner's API key or KNOWLEDGE_ADMIN_KEY. Approved text is chunked and becomes retrievable.
Destructive Open world
Input schema
{'type': 'object', 'required': ['revision_id', 'decision'], 'properties': {'note': {'type': 'string', 'description': 'Optional review note'}, 'decision': {'enum': ['approved', 'rejected'], 'type': 'string'}, 'revision_id': {'type': 'string', 'description': 'Revision id returned by koskamo_propose_revision or koskamo_list_revisions'}}}
Output schema
{'type': 'object'}
koskamo_find_mcp_server
Find an MCP server
Find official, vendor-run remote MCP servers in the Koskamo MCP directory. Every listed endpoint passed a recent live check; returns the endpoint URL, sign-in type, documentation link, and known tools.
Read only Open world Idempotent
Input schema
{'type': 'object', 'properties': {'auth': {'enum': ['none', 'oauth-optional', 'oauth', 'api-key'], 'type': 'string', 'description': 'Optional sign-in filter; none means usable without an account; oauth-optional means public tools work anonymously and account tools prompt OAuth sign-in'}, 'query': {'type': 'string', 'maxLength': 200, 'description': 'Words to match against name, operator, description, use cases, and tool names'}, 'category': {'enum': ['docs-reference', 'developer-tools', 'cloud-infrastructure', 'data-analytics', 'ai-ml', 'commerce', 'payments', 'productivity', 'project-management', 'crm-marketing', 'design'], 'type': 'string', 'description': 'Optional category filter'}}}
Output schema
{'type': 'object', 'required': ['servers'], 'properties': {'servers': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'operator', 'endpoint', 'transport', 'auth', 'category', 'docsUrl', 'directoryUrl'], 'properties': {'id': {'type': 'string'}, 'auth': {'enum': ['none', 'oauth-optional', 'oauth', 'api-key'], 'type': 'string'}, 'name': {'type': 'string'}, 'tools': {'type': 'array', 'items': {'type': 'string'}}, 'docsUrl': {'type': 'string', 'format': 'uri'}, 'category': {'enum': ['docs-reference', 'developer-tools', 'cloud-infrastructure', 'data-analytics', 'ai-ml', 'commerce', 'payments', 'productivity', 'project-management', 'crm-marketing', 'design'], 'type': 'string'}, 'endpoint': {'type': 'string', 'format': 'uri'}, 'operator': {'type': 'string'}, 'useCases': {'type': 'array', 'items': {'type': 'string'}}, 'transport': {'type': 'string'}, 'companyUrl': {'type': 'string', 'format': 'uri', 'description': 'Company website'}, 'verifiedAt': {'type': ['string', 'null']}, 'description': {'type': 'string'}, 'directoryUrl': {'type': 'string', 'format': 'uri'}}}}}}
koskamo_get_history
Get document history
Get the document version timeline for a public dataset: every document (including deleted ones) with the version history produced by approved revisions.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['dataset'], 'properties': {'dataset': {'type': 'string', 'description': 'Dataset id or slug'}}}
Output schema
{'type': 'object'}
koskamo_list_datasets
List public datasets
List public Koskamo datasets an agent may retrieve from.
Read only Open world Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', 'required': ['datasets'], 'properties': {'datasets': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'slug', 'name', 'description', 'visibility', 'version', 'documentCount', 'createdAt'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'license': {'type': 'string', 'description': 'Reuse information, when supplied; consult the original source'}, 'version': {'type': 'integer', 'description': 'Increments every time a document write goes live'}, 'readOnly': {'type': 'boolean', 'description': 'Application-maintained reference datasets do not accept API revisions'}, 'createdAt': {'type': 'string', 'format': 'date-time'}, 'managedBy': {'enum': ['mcp-directory'], 'type': 'string', 'description': 'Documents mirror another Koskamo system of record and change only there; API revisions are refused'}, 'publisher': {'type': 'string', 'description': 'Publisher attribution, when supplied'}, 'reviewedAt': {'type': 'string', 'format': 'date-time', 'description': 'Editorial review date, when supplied'}, 'visibility': {'enum': ['public', 'private'], 'type': 'string'}, 'description': {'type': 'string'}, 'documentCount': {'type': 'integer'}}}}}}
koskamo_list_revisions
List pending revisions
List pending revisions for a dataset.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['dataset'], 'properties': {'dataset': {'type': 'string'}}}
Output schema
{'type': 'object'}
koskamo_propose_revision
Propose a revision
Propose a better fact for a dataset, propose reverting a document to an earlier version, or propose deleting a document. The change stays pending until a dataset owner approves it.
Open world
Input schema
{'type': 'object', 'required': ['dataset'], 'properties': {'text': {'type': 'string', 'description': 'The improved document text; required unless action is delete_document'}, 'title': {'type': 'string', 'description': 'Required unless action is delete_document'}, 'action': {'enum': ['add_document', 'replace_document', 'delete_document'], 'type': 'string', 'description': 'Defaults to add_document. delete_document needs only dataset and document_id.'}, 'dataset': {'type': 'string', 'description': 'Dataset id or slug'}, 'rationale': {'type': 'string'}, 'source_url': {'type': 'string'}, 'document_id': {'type': 'string', 'description': 'Set to replace or delete an existing document'}, 'restore_version': {'type': 'integer', 'minimum': 1, 'description': 'With replace_document and document_id, propose reverting the document to this stored version; title/text are taken from the version history.'}}}
Output schema
{'type': 'object'}
koskamo_register_mcp_server
Register an MCP server
List a remote MCP server you operate in the Koskamo MCP directory, in two calls. Call without token: the server fields are validated and you get a claim token plus where to publish it (https://<endpoint host>/.well-known/koskamo-claim, or TXT _koskamo-claim.<domain>). Publish it, then call again with id and token: once the proof is found and the live check passes, the listing is published and an owner key is returned once. Nothing is listed without both. Without DNS or web access, send method "email" and proofEmail at admin, administrator, webmaster, hostmaster, postmaster on the endpoint's domain: a single-use confirm link is mailed there (the link's token is never returned) and verify succeeds once a person presses Confirm. An email is optional but recommended so we can reach you about auto-hide, a lapsed proof, or key recovery; it gets one confirmation message and nothing else until confirmed, and it never grants ownership. Step-by-step guide with exact proof formats and every refusal: https://koskamo.com/explore/register
Open world
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'description': 'Lowercase kebab-case page id, e.g. acme-docs'}, 'auth': {'enum': ['none', 'oauth-optional', 'oauth', 'api-key'], 'type': 'string', 'description': 'Required on the first call'}, 'name': {'type': 'string', 'maxLength': 80, 'description': 'Product name; required on the first call'}, 'email': {'type': 'string', 'maxLength': 254, 'description': 'Optional, recommended contact address for listing notices'}, 'token': {'type': 'string', 'maxLength': 128, 'description': 'The claim token from the first call; send it to verify and publish'}, 'tools': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional; replaced by the live tool list when the check passes'}, 'method': {'enum': ['http', 'dns', 'email'], 'type': 'string', 'description': 'First call: "email" (with proofEmail) mails a confirm link instead of a token to publish. Verify call: check only this proof method; an email proof needs "email"'}, 'docsUrl': {'type': 'string', 'maxLength': 500, 'description': 'Your documentation page for this server; required on the first call'}, 'category': {'enum': ['docs-reference', 'developer-tools', 'cloud-infrastructure', 'data-analytics', 'ai-ml', 'commerce', 'payments', 'productivity', 'project-management', 'crm-marketing', 'design'], 'type': 'string', 'description': 'Required on the first call'}, 'endpoint': {'type': 'string', 'maxLength': 500, 'description': 'Streamable HTTP endpoint (https); required on the first call'}, 'operator': {'type': 'string', 'maxLength': 80, 'description': 'Company that runs the server; required on the first call'}, 'useCases': {'type': 'array', 'items': {'type': 'string'}, 'description': '1-6 use cases from your documentation; required on the first call'}, 'companyUrl': {'type': 'string', 'maxLength': 500, 'description': 'Optional https company website; an empty string clears it on edits'}, 'proofEmail': {'type': 'string', 'maxLength': 254, 'description': 'First call with method "email": admin|administrator|webmaster|hostmaster|postmaster@<endpoint host or a parent domain>, no plus-tags. A person must open the mailed link and press Confirm before verify succeeds'}, 'description': {'type': 'string', 'maxLength': 600, 'description': '20-600 characters, factual; required on the first call'}}}
Output schema
{'type': 'object'}
koskamo_retrieve
Retrieve cited passages
Look up cited passages from public Koskamo datasets so an agent can answer from facts instead of guessing.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'The question or search string'}, 'top_k': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'dataset': {'type': 'string', 'description': 'Optional dataset id or slug. Defaults to all public datasets.'}}}
Output schema
{'type': 'object', 'required': ['query', 'passages'], 'properties': {'query': {'type': 'string'}, 'passages': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'score', 'datasetId', 'datasetSlug', 'datasetName', 'datasetVersion', 'documentId', 'documentTitle', 'documentVersion', 'sourceUrl', 'chunkId', 'ordinal', 'version', 'createdAt'], 'properties': {'text': {'type': 'string'}, 'score': {'type': 'number', 'description': 'Ranking score within the retrieval engine; not a confidence probability'}, 'chunkId': {'type': 'string', 'description': 'Chunk uuid for database-backed datasets; dataset:document:ordinal for the bundled catalog'}, 'ordinal': {'type': 'integer', 'description': 'Chunk position inside the source document'}, 'version': {'type': 'integer', 'description': 'Alias of datasetVersion kept for existing citers'}, 'createdAt': {'type': 'string', 'format': 'date-time', 'description': 'Document creation timestamp'}, 'datasetId': {'type': 'string'}, 'sourceUrl': {'type': 'string'}, 'documentId': {'type': 'string'}, 'datasetName': {'type': 'string'}, 'datasetSlug': {'type': 'string'}, 'documentTitle': {'type': 'string'}, 'datasetVersion': {'type': 'integer', 'description': 'Dataset version at retrieval time; cite this'}, 'documentVersion': {'type': 'integer', 'description': 'Document content version; increments when an approved revision replaces the document'}}}}}}
Added
koskamo_register_mcp_server
Oct. 5, 2026, 2:43 a.m.
Added
koskamo_find_mcp_server
Oct. 5, 2026, 2:43 a.m.
Changed
koskamo_decide_revision
Oct. 5, 2026, 2:43 a.m.
Changed
koskamo_list_revisions
Oct. 5, 2026, 2:43 a.m.
Changed
koskamo_get_history
Oct. 5, 2026, 2:43 a.m.
Changed
koskamo_propose_revision
Oct. 5, 2026, 2:43 a.m.
Changed
koskamo_list_datasets
Oct. 5, 2026, 2:43 a.m.
Changed
koskamo_retrieve
Oct. 5, 2026, 2:43 a.m.
Added
koskamo_decide_revision
Sept. 23, 2026, 2:40 a.m.
Added
koskamo_list_revisions
Sept. 23, 2026, 2:40 a.m.
Added
koskamo_get_history
Sept. 23, 2026, 2:40 a.m.
Added
koskamo_propose_revision
Sept. 23, 2026, 2:40 a.m.
Added
koskamo_list_datasets
Sept. 23, 2026, 2:40 a.m.
Added
koskamo_retrieve
Sept. 23, 2026, 2:40 a.m.