mcpservers.org API

openapi: 3.1.0
info:
  title: mcpservers.org API
  version: '2026-10-18'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-18: 15 operation(s) read from 8 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; mcpservers.org has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 4
    documentation: 11
    pages-with-code: 4
    pages-read: 8
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-18'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://mcpservers.org/remote-mcp-servers
  - https://mcpservers.org/servers/neondatabase/mcp-server-neon
  - https://mcpservers.org/servers/notion-mcp-server
  - https://mcpservers.org/servers/402cron-com
  - https://mcpservers.org/servers/402post-com
  - https://mcpservers.org/servers/402registry-com
  - https://mcpservers.org/servers/brissux-labs/4bl1ty-mcp
  - https://mcpservers.org/servers/trust-the825-co-docs
paths:
  /.well-known/agent-card.json:
    get:
      operationId: get_well_known_agent_card_json
      tags:
      - API
      summary: The public Agent Card is served without authentication and describes the service's declared skills and security schemes.
      x-source: https://mcpservers.org/servers/trust-the825-co-docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent-city.json:
    get:
      operationId: get_agent_city_json
      tags:
      - Agent City
      summary: The Agent City catalog publishes first‑party service capabilities and availability without prices, credentials, or customer data.
      x-source: https://mcpservers.org/servers/trust-the825-co-docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/destinations/{id}/verify:
    post:
      operationId: post_api_destinations_id_verify
      tags:
      - Api
      summary: Prove the destination.
      description: 'Verification request sent within 15 minutes of registering a destination. The request must include headers `X-402cron-Challenge`
        and `X-402cron-Event: verify` and a JSON body `{ "challenge": "..." }`. The endpoint must reply within 5 seconds with either the bare
        challenge value or a JSON object containing the same challenge.'
      x-source: https://mcpservers.org/servers/402cron-com
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDestinationsIdVerifyRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/list-tools:
    get:
      operationId: get_api_list_tools
      tags:
      - Api
      summary: GET /api/list-tools
      x-source: https://mcpservers.org/servers/neondatabase/mcp-server-neon
      parameters:
      - name: category
        in: query
        required: false
        schema:
          type: string
      - name: readonly
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://mcp.neon.tech/api/list-tools?readonly=true&category=querying\"\n Tools available in read-only mode \n Host tools:\
          \ list_organizations , describe_branch , run_sql , get_database_tables , describe_table_schema , list_slow_queries , explain_sql_statement\
          \ , inspect_database , get_neon_auth_config , search , fetch , list_docs_resources , get_doc_resource , send_feedback . \n Generated\
          \ Manageme"
  /auth/api-keys:
    post:
      operationId: post_auth_api_keys
      tags:
      - Auth
      summary: API key created from a signed-in 4bl1ty account
      description: Creates an API key for a signed‑in 4bl1ty account; the key is used for authenticating subsequent MCP requests.
      x-source: https://mcpservers.org/servers/brissux-labs/4bl1ty-mcp
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /mcp:
    get:
      operationId: get_mcp
      tags:
      - Mcp
      summary: GET /mcp
      x-source: https://mcpservers.org/remote-mcp-servers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl, Requests, HTTPX and Playwright, and diagnose proxy errors such as a CONNECT 407. Ironclad Contracts Ironclad Contracts
          provides plain-language search for contract answers. Its connector brings contract repository context into assistant workflows so legal
          and business teams can find agreement terms, obligations, and related records faster. Is It Down API Is a vendor down right now? Status
          and
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: POST /mcp
      x-source: https://mcpservers.org/servers/notion-mcp-server
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \"Authorization: Bearer your-token-here\"  -H \"Content-Type: application/json\"  -H \"mcp-session-id: your-session-id\"\
          \  -d '{\"jsonrpc\": \"2.0\", \"method\": \"initialize\", \"params\": {}, \"id\": 1}'  http://localhost:3000/mcp\n Note: Make sure to\
          \ set either the NOTION_TOKEN environment variable (recommended) or the OPENAPI_MCP_HEADERS environment variable with your Notion integration\
          \ token when using e"
  /submit:
    post:
      operationId: post_submit
      tags:
      - Submit
      summary: The one exception is POST /submit , which is free and takes {"host":"example.com"} .
      x-source: https://mcpservers.org/servers/402registry-com
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSubmitRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/audit/verify:
    get:
      operationId: get_v1_audit_verify
      tags:
      - Audit
      summary: GET /v1/audit/verify independently checks that the append‑only, digest‑chained event log has not been altered.
      x-source: https://mcpservers.org/servers/trust-the825-co-docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/execute:
    post:
      operationId: post_v1_execute
      tags:
      - Execute
      summary: POST /v1/execute runs one dispatcher skill for the authenticated principal.
      x-source: https://mcpservers.org/servers/trust-the825-co-docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/pages/{pageId}/markdown:
    get:
      operationId: get_v1_pages_pageId_markdown
      tags:
      - Pages
      summary: Read a page's full content as Markdown
      x-source: https://mcpservers.org/servers/notion-mcp-server
      parameters:
      - name: pageId
        in: path
        required: true
        schema:
          type: string
      - name: include_transcript
        in: query
        required: false
        schema:
          type: string
        description: Set to true to inline meeting-note transcripts.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1PagesPageidMarkdownResponse'
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_v1_pages_pageId_markdown
      tags:
      - Pages
      summary: Edit a page's content with Markdown
      x-source: https://mcpservers.org/servers/notion-mcp-server
      parameters:
      - name: pageId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchV1PagesPageidMarkdownRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchV1PagesPageidMarkdownResponse'
      x-evidence:
        kind: documentation
  /v1/posts:
    post:
      operationId: post_v1_posts
      tags:
      - Posts
      summary: How an agent posts a listing
      description: Post and pay the listing. Server answers 402 Payment Required with the price; after signing the USDC payment on Base, resend
        the request. Returns page address, edit key, and expiry date.
      x-source: https://mcpservers.org/servers/402post-com
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PostsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1PostsResponse'
      x-evidence:
        kind: documentation
  /v1/posts/validate:
    post:
      operationId: post_v1_posts_validate
      tags:
      - Posts
      summary: POST /v1/posts/validate
      x-source: https://mcpservers.org/servers/402post-com
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PostsValidateRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://402post.com/v1/posts/validate  -H 'content-type: application/json'  -d '{\"category\":\"agent-services\"\
          ,\"subcategory\":\"translation\",\"intent\":\"offer\",\n \"title\":\"Technical translation EN-DE by an agent\",\"body\":\"…200 to 5000\
          \ characters…\",\n \"lang\":\"en\",\"location\":{\"scope\":\"online\"},\"contact\":{\"email\":\"you@example.com\"}}'\n For programs\
          \ \n Every listing is also at /p/{id}.md and /p/{id}"
  /v1/skills:
    get:
      operationId: get_v1_skills
      tags:
      - Skills
      summary: GET /v1/skills lists what your credential can call.
      x-source: https://mcpservers.org/servers/trust-the825-co-docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiDestinationsIdVerifyRequest:
      type: object
      properties:
        challenge:
          type: string
          description: Challenge value to be echoed back.
      required:
      - challenge
    PostMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        method:
          type: string
        params:
          type: object
        id:
          type: integer
    PostSubmitRequest:
      type: object
      properties:
        host:
          type: string
          description: example.com
      required:
      - host
    GetV1PagesPageidMarkdownResponse:
      type: object
      properties:
        markdown:
          type: string
          description: The page content rendered in Markdown format.
    PatchV1PagesPageidMarkdownRequest:
      type: object
      properties:
        replace_content:
          type: string
          description: Replace the whole page content with this Markdown.
        update_content:
          type: object
          description: Targeted find-and-replace edits; specify find and replace strings.
    PatchV1PagesPageidMarkdownResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates whether the update was applied.
    PostV1PostsRequest:
      type: object
      properties:
        category:
          type: string
        subcategory:
          type: string
        intent:
          type: string
        title:
          type: string
        body:
          type: string
        lang:
          type: string
        location:
          type: object
          description: e.g. {"scope":"online"}
        contact:
          type: object
          description: e.g. {"email":"you@example.com"}
        listings:
          type: array
          description: array of listing objects for batch posting (up to 15)
      required:
      - category
      - subcategory
      - intent
      - title
      - body
      - lang
      - location
      - contact
    PostV1PostsResponse:
      type: object
      properties:
        page_address:
          type: string
          description: URL of the created listing page
        edit_key:
          type: string
          description: key for editing or removing the listing (shown once)
        expiry_date:
          type: string
          description: date when the listing expires
    PostV1PostsValidateRequest:
      type: object
      properties:
        category:
          type: string
        subcategory:
          type: string
        intent:
          type: string
        title:
          type: string
        body:
          type: string
        lang:
          type: string
        location:
          type: object
          properties:
            scope:
              type: string
        contact:
          type: object
          properties:
            email:
              type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: API
- name: Agent City
- name: Api
- name: Audit
- name: Auth
- name: Execute
- name: Mcp
- name: Pages
- name: Posts
- name: Skills
- name: Submit