ayushrai-site MCP API

openapi: 3.2.0
info:
  title: Ayush Rai public MCP API
  version: 1.0.0
  description: 'Read-only API over the same public content as Ayush Rai''s website. Unverified award metrics are omitted. There is no separate dataset for this API.


    Access: Free and public. No account or API key is needed because every endpoint is read-only over published content. There is no separate test environment or paid tier. Clients may cache responses for five minutes. REST responses grant CORS only to the site''s own origins, so call the REST API from a server, an agent, or the CLI rather than from a browser page on another site. The MCP endpoint and its Server Card allow any origin.


    Rate limits: 60 requests per 60 seconds per client address, counted per server instance. Every response carries RateLimit-Policy and RateLimit headers (draft-ietf-httpapi-ratelimit-headers-11). Over the limit, the API returns 429 with a Retry-After header in seconds and error code rate_limited.


    Errors: every error body is { "error": { "code", "message", "hint", "docs" } }. code is stable; hint says how to fix the request.


    Versioning: Versioned in the URL path. /api/v1 is stable: fields may be added, but none are removed or renamed. Breaking changes ship under a new path such as /api/v2. A replaced version keeps working for at least 90 days; during that window its responses carry Deprecation and Sunset headers and a Link with rel="successor-version", and the dates are listed on /developers. The unversioned /api/search and /api/projects are aliases of v1 and follow the same policy. No version is deprecated today.


    MCP: the same project and search tools are available over Streamable HTTP at POST /api/mcp. Its Server Card is at GET /api/mcp/server-card.'
  contact:
    name: Ayush Rai
    email: ayushrai0211@gmail.com
    url: https://www.ayushrai.site/developers/
servers:
- url: https://www.ayushrai.site
security: []
tags:
- name: MCP
paths:
  /api/mcp/server-card:
    get:
      operationId: getMcpServerCard
      summary: MCP Server Card for the Streamable HTTP endpoint
      description: SEP-2127 Server Card. Supports ETag and If-None-Match. The card itself conforms to https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json.
      responses:
        '200':
          description: Server Card
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            ETag:
              description: Entity tag of the card
              schema:
                type: string
          content:
            application/mcp-server-card+json:
              schema:
                $ref: '#/components/schemas/ServerCard'
        '304':
          description: Not modified since the ETag sent in If-None-Match
        '405':
          description: Unsupported HTTP method. error.code is method_not_allowed. REST accepts GET, HEAD, and OPTIONS.
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded. error.code is rate_limited.
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - MCP
components:
  headers:
    RetryAfter:
      description: Seconds to wait before retrying.
      schema:
        type: integer
        minimum: 1
    RateLimit:
      description: Remaining quota and seconds until reset, for example "default";r=59;t=60.
      schema:
        type: string
    RateLimitPolicy:
      description: 'Quota policy: "default";q=60;w=60.'
      schema:
        type: string
  schemas:
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          - hint
          - docs
          properties:
            code:
              type: string
              enum:
              - invalid_query
              - invalid_slug
              - invalid_filter
              - invalid_compare
              - invalid_cursor
              - not_found
              - route_not_found
              - method_not_allowed
              - rate_limited
              - internal_error
            message:
              type: string
              description: What was wrong with this request
            hint:
              type: string
              description: How to fix the request
            docs:
              type: string
              format: uri
    ServerCard:
      type: object
      required:
      - $schema
      - name
      - version
      - description
      properties:
        $schema:
          type: string
          const: https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json
        name:
          type: string
          pattern: ^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$
        version:
          type: string
        description:
          type: string
          maxLength: 100
        title:
          type: string
        websiteUrl:
          type: string
          format: uri
        repository:
          type: object
          required:
          - url
          - source
          properties:
            url:
              type: string
              format: uri
            source:
              type: string
        remotes:
          type: array
          items:
            type: object
            required:
            - type
            - url
            properties:
              type:
                type: string
                enum:
                - streamable-http
                - sse
              url:
                type: string
              supportedProtocolVersions:
                type: array
                items:
                  type: string
externalDocs:
  description: Developer notes
  url: https://www.ayushrai.site/developers/