Registers an MCP server, a skill or a plugin in the catalog. It comes in as `pending`.

Automatic review approves supported low-risk MCP listings; uncertain cases wait for a person. Poll status_api (GET /api/listings/:id/status, no credential) to learn the decision. A person or agent can submit without an account. While billing is off, no payment is required. Each owner can submit once a day and keep up to three submissions in the queue. For a skill, provide its SKILL.md URL. If agent billing is enabled, the reference price is US$ 0.10 per submission, paid through x402 or prepaid credit. The service checks the body and quota before charging. An invalid body returns 400; an exhausted quota returns 429. Returns: { ok, id, status, status_api }

post/api/listings

Request

  • Base URL: https://agentalog.com
  • URL: https://agentalog.com/api/listings
  • Auth: one of:
    • API key in cookie __Host-mm-auth
    • HTTP bearer
    • API key in header X-PAYMENT

Request body

kind'mcp' | 'skill' | 'plugin' | 'okf' required

What is being registered.

urlstring required

MCP endpoint, SKILL.md URL, the plugin's repository or the OKF bundle's index.md. For an OKF bundle on a domain you control, POST /api/okf/ping is free.

namestring

Display name; without it, taken from the source.

taglinestring

One line saying what it is for.

bodystring

Long description, optional.

categorystring

Category so the listing shows up under the right filter.

Response

{ ok, id, status, status_api }

okboolean required

Always true when the request went in.

idstring required

ID of the created listing.

statusstring required

Always pending: everything goes through the queue before turning live.

status_apistring required

Where to poll for the review, with no credential (GET /api/listings/:id/status).

Changes

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