mcp-directory

Self-register an MCP server you operate (step one)

No account needed; requires the application's trusted ingress. Validates the fields and returns a claim token with where to publish it: https://<endpoint host>/.well-known/koskamo-claim or TXT _koskamo-claim.<domain>. Nothing is listed or queued until step two finds the proof and the live check passes. The registration expires after 7 days. Refused with 409 when the id is taken or another listing already uses the endpoint host (the response points to the claim and key-recovery flows). Rate limit: 5 requests per hour per IP. Same flow as the koskamo_register_mcp_server MCP tool. Email ownership proof: send method "email" with proofEmail at one of admin, administrator, webmaster, hostmaster, postmaster (no plus-tags) on the endpoint host or a parent domain. A single-use confirm link (expires in 48 hours) is mailed there and never returned; once a person presses Confirm, call verify with method "email". Limits: 3 mails per address per day, 5 per IP per hour; starting again sends a new link and voids the old one. A confirmed email proof lapses after 365 days.

post/api/v1/mcp-directory/servers

Request

  • Base URL: https://koskamo.com
  • URL: https://koskamo.com/api/v1/mcp-directory/servers
  • Auth: none declared

Request body

idstring required

Page id; the listing lives at /explore/{id}

namestring required
operatorstring required

Company that runs the server

endpointstring uri required

Streamable HTTP endpoint, https

category'docs-reference' | 'developer-tools' | 'cloud-infrastructure' | 'data-analytics' | 'ai-ml' | 'commerce' | 'payments' | 'productivity' | 'project-management' | 'crm-marketing' | 'design' required
auth'none' | 'oauth-optional' | 'oauth' | 'api-key' required
descriptionstring required
useCasesstring[] required
requirementsstring[]

Optional prerequisites a user must already have (vendor account, subscription, issued key), beyond endpoint sign-in

docsUrlstring uri required

Your documentation page for this server

companyUrlstring

Optional https company website; an empty string clears it on edits

toolsstring[]

Replaced by the live tool list on every passing check

emailstring email

Optional but recommended, so we can reach you about auto-hide, lapsed proof, or key recovery. It receives one confirmation message and nothing else until confirmed, is never shown publicly, and never grants ownership.

method'email'

Send "email" with proofEmail for an email ownership proof; omit for a token to publish

proofEmailstring email

admin|administrator|webmaster|hostmaster|postmaster@<endpoint host or parent domain>

Response

Token issued; publish it, then call the verify URL

contactstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.