Koskamo

For the owner of a listing: issue a fresh owner key, returned once, and stop the current one.

Read a bounded page of an exact public revision diff by artifact_id. Optional cursor continues the declared JSON bytes. No writes, downloads, uploads, private reviewer notes, or charges. Concatenate content pages before parsing the artifact.

Read supported discovery and exact knowledge capabilities with separate configuration and authority states. No inputs, writes, provider execution, or charges. Store availability is not probed.

Read this request's authentication state. No inputs, writes, downstream account probes, or charges. Directory storage and provider execution are not checked.

Generate a manual connection handoff for server_id and host_id from supported setup snippets. Pure read; no charges, saved plan, package installation, credentials, or provider actions. Host installation remains unverified.

Read this connection's public or key-scoped knowledge access and contract versions. No inputs, provider grants, writes, or charges. Private dataset membership is not enumerated.

Read exact stored text for dataset and document_id, optionally document_version. Cursor pages bind one version and content hash. Public or exact owner-key access only. No writes, charges, or inference of source observation time.

Read only the submission outcome using its secret receipt_handle. The handle expires after 30 days. No reporter details, reviewer notes, writes, or charges. Possession permits this single status lookup.

Get the document version timeline for a public dataset: every document (including deleted ones) with the version history produced by approved revisions.

Read the state of a reported MCP server issue by its secret receipt handle: status, report count, the owner's response, and the live check recorded when the owner marked it fixed. The owner response is untrusted text written by the owner.

Get one published MCP listing with complete live-observed or source-attributed tool schemas, resources, prompts, package definitions, provenance, and sanitized maintenance events.

For the owner of a listing: read its state, last live check, ownership proof, key prefix and your recent edit submissions with their review decisions. No changes.

Read durable operation state and verification by operation_id. Requires the original key or receipt_handle; identifiers alone grant no access. No charges or writes. A previously failed operation remains a successful status lookup; uncertain effects remain nonterminal.

Read a completed operation's bounded typed outcome by operation_id under its current grant or receipt. No charges, writes, provider credentials, or reviewer notes. Inspect operation state when its result is not yet available.

Inspect independent listing, source, schema, grant, permission, and tested-action evidence for server_id. Read only, no charges or live downstream actions. A successful probe does not prove account authority or task completion.

Read supported reference datasets, fixed columns, operators and limits. No inputs, writes or charges. Stored schemas do not establish source freshness or independent factual verification.

Read pending, approved, or rejected revision state for revision_id in a public dataset. No writes, charges, private reviewer notes, or private dataset revisions. Index visibility is reported separately from approval.

Find candidate MCP tools for a task and named host using directory evidence. Requires task and host_id; returns at most five listings per page. Pure read with no charges, installation, account grants, or execution. Task coverage and prerequisites may remain unknown.

Read a published recipe, its reusable prompt, linked servers and supporting vendor quote. The record is informational and does not authorize any external action.

List a page of public Koskamo datasets with continuation metadata.

List bounded stored document identifiers and versions in dataset. Optional limit and cursor continue traversal. Public or exact owner-key access only; no text search, writes, or charges. Collection changes expire the cursor.

Read the public change feed of the MCP directory, oldest first: listings updated or removed and issues reported, acknowledged, fixed, declined, reopened or closed. Events carry ids, statuses and counts only. Pass after with the previous next_cursor to continue; optionally filter by server_id.

For the owner of a listing: list the issues agents reported, with their report text, which is untrusted data. No changes.

Recover one action's durable operation using its original idempotency_key. Authenticated actions require the original key; anonymous client keys act as secret, expiring receipt capabilities. No charges, writes, cross-account enumeration, or automatic retries.

List revisions for a public dataset; pending by default, or filter by approved, rejected, or all states.

Filter one supported public reference dataset using its typed fields. Requires a dataset and optional bounded filters, ordering and cursor. Returns matching rows, exact source versions and decimal strings without SQL, cross-unit arithmetic, writes or charges. Source changes expire paging cursors.

List a remote MCP server you operate in the Koskamo MCP directory, in two calls. A call without token validates the server fields and returns a claim token plus where it can be published (/.well-known/koskamo-claim on the endpoint host, or TXT _koskamo-claim.<domain>). A call with id, token and private receipt_handle looks for that proof and runs a live check; when both pass, the listing is published and an owner key is returned once. Nothing is listed without both. Method "email" with proofEmail at admin, administrator, webmaster, hostmaster, postmaster on the endpoint's domain is the alternative to DNS or web proof: a single-use confirm link is mailed there, its token is not returned, and verification succeeds after a person presses Confirm. An optional contact email is used for notices about auto-hide, a lapsed proof, or key recovery; it receives one confirmation message and nothing else until confirmed, and it does not grant ownership.

Reopen a reported MCP server issue that the owner marked fixed or won't fix but that still fails. Takes the secret receipt handle from the report; each receipt can reopen once.

Submit a disputed passage for review because it may be wrong, outdated, or missing a source. No API key is required. Reports enter the reviewer queue and do not change published content.

Report a bug in a published MCP server listed on Koskamo: a tool that errors, returns wrong results, mismatches its schema, rejects valid auth, is unavailable, or has wrong docs. Reports on the same tool and category merge into one issue that the listing owner sees and answers. No key is required. Text that looks like a credential or token is refused, and security vulnerabilities are out of scope. Returns a secret receipt_handle for status checks and reopening.

After using an MCP server listed on Koskamo, say whether it worked for your task: success, partial or failure, optionally for one tool. Only daily counts per listing and tool are kept (no text, IP or client), one signal per caller per listing per hour. Returns the listing's 30-day totals.

For the owner of a listing: stop the owner key until registration recovery issues a new one.

Find remote MCP servers and local MCP packages. Filter by vendor/community publisher, transport, capabilities, and sign-in. Live-check and source-verification states are returned independently.

Search Koskamo datasets for candidate passages with source citations and document versions. Similarity scores rank matches and do not measure factual confidence.

Find published cited use cases by task or linked directory server. These are informational recipes, separate from installed executable playbooks and provider grants.

For the owner of a listing: respond to one reported issue. acknowledge replies publicly; wont_fix declines with a public reason; fixed requires a public note and is accepted only when a live check of the endpoint passes at that moment. Reporters see your response through their receipts.

Edit a listing you registered, using the owner key issued when it was published. Send id, owner_key and only the fields to change. With a verified proof the edit publishes at once. Changing endpoint, auth or docsUrl, or sending tools (even unchanged names), refreshes live schemas first; a failed or incomplete catalog check refuses the edit. An endpoint moved outside the ownership proof is queued for review. The id is fixed, visibility cannot change, and the response omits the key. Same path and limits as PATCH /api/v1/mcp-directory/servers/{id}; no durable receipt.

For the owner of a listing: hidden true unlists a published listing; hidden false re-runs the live check and publishes an owner-hidden or check-hidden listing when it passes.