MCP-Server

Koskamo

com.koskamo/koskamo
Wissen & Dokumentation Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

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.
Destruktiv Externer Zugriff
Eingabeschema
{'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'}}}
Ausgabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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'}}}
Ausgabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['dataset'], 'properties': {'dataset': {'type': 'string', 'description': 'Dataset id or slug'}}}
Ausgabeschema
{'type': 'object'}
koskamo_list_datasets
List public datasets
List public Koskamo datasets an agent may retrieve from.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
Ausgabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['dataset'], 'properties': {'dataset': {'type': 'string'}}}
Ausgabeschema
{'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.
Externer Zugriff
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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
Externer Zugriff
Eingabeschema
{'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'}}}
Ausgabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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'}}}}}}
Hinzugefügt
koskamo_register_mcp_server
5. October 2026 02:43
Hinzugefügt
koskamo_find_mcp_server
5. October 2026 02:43
Geändert
koskamo_decide_revision
5. October 2026 02:43
Geändert
koskamo_list_revisions
5. October 2026 02:43
Geändert
koskamo_get_history
5. October 2026 02:43
Geändert
koskamo_propose_revision
5. October 2026 02:43
Geändert
koskamo_list_datasets
5. October 2026 02:43
Geändert
koskamo_retrieve
5. October 2026 02:43
Hinzugefügt
koskamo_decide_revision
23. September 2026 02:40
Hinzugefügt
koskamo_list_revisions
23. September 2026 02:40
Hinzugefügt
koskamo_get_history
23. September 2026 02:40
Hinzugefügt
koskamo_propose_revision
23. September 2026 02:40
Hinzugefügt
koskamo_list_datasets
23. September 2026 02:40
Hinzugefügt
koskamo_retrieve
23. September 2026 02:40