Alternativas IA

Alternativas IA .well Known API

The .well Known API from Alternativas IA — 15 operation(s) for .well known.

GitHub OpenAPI

Operations 15

GET /.well-known/agents.json Agent discovery document #
GET /.well-known/api-catalog RFC 9727 API catalog linkset #
GET /.well-known/ai-catalog.json AI catalog pointing at the MCP server card #
GET /.well-known/mcp MCP Streamable HTTP pointer #
GET /.well-known/mcp/server-card.json MCP server card #
GET /.well-known/agent-permissions.json What agents may and may not do #
GET /.well-known/agent-card.json A2A agent card #
GET /.well-known/agent-mode.json Agent mode and sandbox label #
GET /.well-known/ai-plugin.json Plugin manifest (auth none) #
GET /.well-known/oauth-authorization-server RFC 8414 metadata (human NextAuth only) #
GET /.well-known/http-message-signatures-directory HTTP Message Signatures directory #
GET /.well-known/mcp.json MCP server card + mcpServers manifest (url is /api/mcp/mcp) #
GET /.well-known/sandbox.json Sandbox flag (always false — production only) #
GET /.well-known/schema-map.xml Well-known schema-feed map #
GET /.well-known/function-calling.json OpenAI-compatible function declarations for MCP tools #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/alternativasia-com/openapi/alternativasia-com-well-known-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/alternativasia-com/json-schema/alternativasia-com-listing-page-schema.json
📊
JSONSchema
https://artifacts.apis.io/alternativasia-com/json-schema/alternativasia-com-me-schema.json
📊
JSONSchema
https://artifacts.apis.io/alternativasia-com/json-schema/alternativasia-com-mcp-rpc-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/alternativasia-com:alternativasia-com-well-known-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

alternativasia-com-well-known-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Alternativas IA HTTP surfaces .well Known API
  version: 1.20.0
  summary: Machine-readable map of the real HTTP endpoints on alternativasia.com.
  description: 'Alternativas IA is served from this origin. Query the catalog through the MCP endpoint documented here — there is no parallel REST catalog. Unknown /api paths return JSON { error, status }. Public HTML pages also speak markdown at the same URL (Accept: text/markdown). Rate limit: 120 requests / 60s (IETF RateLimit + RateLimit-Policy; Retry-After on 429). URL path /api/v1 is the current catalog JSON. Responses also send API-Version: 1. Breaking changes ship under /api/v2. Deprecated versions get Deprecation and Sunset headers for at least 90 days. There is no v2 yet.'
servers:
- url: https://alternativasia.com
tags:
- name: .well Known
paths:
  /.well-known/agents.json:
    get:
      summary: Agent discovery document
      operationId: getAgentsJson
      responses:
        '200':
          description: Agent discovery document
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/api-catalog:
    get:
      summary: RFC 9727 API catalog linkset
      operationId: getApiCatalog
      responses:
        '200':
          description: Linkset
          content:
            application/linkset+json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/ai-catalog.json:
    get:
      summary: AI catalog pointing at the MCP server card
      operationId: getAiCatalog
      responses:
        '200':
          description: AI catalog pointing at the MCP server card
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/mcp:
    get:
      summary: MCP Streamable HTTP pointer
      operationId: getMcpWellKnown
      responses:
        '200':
          description: MCP Streamable HTTP pointer
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/mcp/server-card.json:
    get:
      summary: MCP server card
      operationId: getMcpServerCard
      responses:
        '200':
          description: MCP server card
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/agent-permissions.json:
    get:
      summary: What agents may and may not do
      operationId: getAgentPermissions
      responses:
        '200':
          description: What agents may and may not do
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/agent-card.json:
    get:
      summary: A2A agent card
      operationId: getAgentCard
      responses:
        '200':
          description: A2A agent card
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/agent-mode.json:
    get:
      summary: Agent mode and sandbox label
      operationId: getAgentMode
      responses:
        '200':
          description: Agent mode and sandbox label
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/ai-plugin.json:
    get:
      summary: Plugin manifest (auth none)
      operationId: getAiPlugin
      responses:
        '200':
          description: Plugin manifest (auth none)
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/oauth-authorization-server:
    get:
      summary: RFC 8414 metadata (human NextAuth only)
      operationId: getAsMetadata
      responses:
        '200':
          description: RFC 8414 metadata (human NextAuth only)
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/http-message-signatures-directory:
    get:
      summary: HTTP Message Signatures directory
      operationId: getWebBotAuthDirectory
      responses:
        '200':
          description: HTTP Message Signatures directory
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/mcp.json:
    get:
      summary: MCP server card + mcpServers manifest (url is /api/mcp/mcp)
      operationId: getMcpJson
      responses:
        '200':
          description: MCP server card + mcpServers manifest (url is /api/mcp/mcp)
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/sandbox.json:
    get:
      summary: Sandbox flag (always false — production only)
      operationId: getSandbox
      responses:
        '200':
          description: Sandbox flag (always false — production only)
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/schema-map.xml:
    get:
      summary: Well-known schema-feed map
      operationId: getSchemaMapWellKnown
      responses:
        '200':
          description: Well-known schema-feed map
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
  /.well-known/function-calling.json:
    get:
      summary: OpenAI-compatible function declarations for MCP tools
      operationId: getFunctionCalling
      responses:
        '200':
          description: OpenAI-compatible function declarations for MCP tools
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
components:
  securitySchemes:
    CatalogScopes:
      type: oauth2
      description: Named permission scopes this origin documents. Public catalog reads need no token (catalog:read). catalog:write is submit_tool only. There is no agent token endpoint.
      flows:
        authorizationCode:
          authorizationUrl: https://alternativasia.com/api/auth/signin
          tokenUrl: https://alternativasia.com/api/auth/signin
          scopes:
            catalog:read: Public catalog reads (HTML, markdown, MCP read tools, /api/v1/listings, /ask)
            catalog:write: submit_tool creates a DRAFT the maker must claim