Ask Sage MCP Servers API
Model Context Protocol server management
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ask-sage:ask-sage-mcp-servers-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Ask Sage Server MCP Servers API
description: Ask Sage is an AI-powered platform providing intelligent completions, knowledge management, and workflow automation.
version: '2.0'
contact:
name: Ask Sage Support
email: support@asksage.ai
url: https://asksage.ai
servers:
- url: '{baseUrl}/server'
description: Ask Sage Server API
variables:
baseUrl:
default: https://api.asksage.ai
description: API base URL. Use https://api.asksage.ai for production, or your self-hosted instance URL.
security:
- ApiKeyAuth: []
tags:
- name: MCP Servers
description: Model Context Protocol server management
paths:
/add-mcp-server:
post:
summary: Add MCP server
description: Add a new MCP (Model Context Protocol) server for the user
tags:
- MCP Servers
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MCPServer'
responses:
'200':
description: MCP server added successfully
content:
application/json:
schema:
type: object
properties:
response:
type: string
server_id:
type: integer
status:
type: integer
operationId: postAddMcpServer
x-operation-id-source: derived
get:
summary: Add MCP server (GET)
description: Add a new MCP (Model Context Protocol) server for the user (GET method supported)
tags:
- MCP Servers
responses:
'200':
description: MCP server added successfully
content:
application/json:
schema:
type: object
properties:
response:
type: string
server_id:
type: integer
status:
type: integer
operationId: getAddMcpServer
x-operation-id-source: derived
/update-mcp-server:
put:
summary: Update MCP server
description: Update an existing MCP server configuration
tags:
- MCP Servers
requestBody:
required: true
content:
application/json:
schema:
allOf:
- type: object
required:
- server_id
properties:
server_id:
type: integer
description: ID of the server to update
- $ref: '#/components/schemas/MCPServer'
responses:
'200':
description: MCP server updated successfully
content:
application/json:
schema:
type: object
properties:
response:
type: string
server_id:
type: integer
status:
type: integer
operationId: putUpdateMcpServer
x-operation-id-source: derived
/list-mcp-servers:
get:
summary: List user's MCP servers
description: Get a list of all MCP servers configured for the user
tags:
- MCP Servers
parameters:
- name: include_inactive
in: query
schema:
type: boolean
default: false
description: Include inactive servers in the list
responses:
'200':
description: List of MCP servers
content:
application/json:
schema:
type: object
properties:
response:
type: array
items:
type: object
count:
type: integer
status:
type: integer
operationId: getListMcpServers
x-operation-id-source: derived
post:
summary: List user's MCP servers (POST)
description: Get a list of all MCP servers configured for the user
tags:
- MCP Servers
requestBody:
content:
application/json:
schema:
type: object
properties:
include_inactive:
type: boolean
default: false
description: Include inactive servers
responses:
'200':
description: List of MCP servers
content:
application/json:
schema:
type: object
properties:
response:
type: array
items:
type: object
count:
type: integer
status:
type: integer
operationId: postListMcpServers
x-operation-id-source: derived
/list-mcp-whitelisted-servers:
get:
summary: List whitelisted MCP servers
description: Get a list of all whitelisted MCP servers
tags:
- MCP Servers
responses:
'200':
description: List of whitelisted servers
content:
application/json:
schema:
type: object
properties:
response:
type: array
items:
type: string
status:
type: integer
operationId: getListMcpWhitelistedServers
x-operation-id-source: derived
post:
summary: List whitelisted MCP servers (POST)
description: Get a list of all whitelisted MCP servers
tags:
- MCP Servers
responses:
'200':
description: List of whitelisted servers
content:
application/json:
schema:
type: object
properties:
response:
type: array
items:
type: string
status:
type: integer
operationId: postListMcpWhitelistedServers
x-operation-id-source: derived
/list-mcp-tools:
get:
summary: List MCP tools
description: Get a list of all available MCP tools from configured servers
tags:
- MCP Servers
responses:
'200':
description: List of MCP tools
content:
application/json:
schema:
type: object
properties:
response:
type: array
items:
type: object
count:
type: integer
status:
type: integer
operationId: getListMcpTools
x-operation-id-source: derived
post:
summary: List MCP tools (POST)
description: Get a list of all available MCP tools from configured servers
tags:
- MCP Servers
responses:
'200':
description: List of MCP tools
content:
application/json:
schema:
type: object
properties:
response:
type: array
items:
type: object
count:
type: integer
status:
type: integer
operationId: postListMcpTools
x-operation-id-source: derived
/delete-mcp-server:
delete:
summary: Delete MCP server
description: Soft delete an MCP server by setting it as inactive
tags:
- MCP Servers
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- server_id
properties:
server_id:
type: integer
description: ID of the server to delete
responses:
'200':
description: Server deleted successfully
content:
application/json:
schema:
type: object
properties:
response:
type: string
server_id:
type: integer
status:
type: integer
'404':
description: Server not found or access denied
operationId: deleteDeleteMcpServer
x-operation-id-source: derived
post:
summary: Delete MCP server (POST)
description: Soft delete an MCP server by setting it as inactive
tags:
- MCP Servers
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- server_id
properties:
server_id:
type: integer
description: ID of the server to delete
responses:
'200':
description: Server deleted successfully
content:
application/json:
schema:
type: object
properties:
response:
type: string
server_id:
type: integer
status:
type: integer
'404':
description: Server not found or access denied
operationId: postDeleteMcpServer
x-operation-id-source: derived
components:
schemas:
MCPServer:
type: object
required:
- server_name
- server_url
properties:
server_name:
type: string
minLength: 1
maxLength: 100
pattern: ^[a-zA-Z0-9\s\-_.]+$
description: Name of the MCP server
server_url:
type: string
minLength: 1
maxLength: 2048
description: HTTPS URL of the MCP server
server_type:
type: string
maxLength: 50
pattern: ^[a-zA-Z0-9\-_]+$
description: Type of MCP server
description:
type: string
maxLength: 1000
description: Description of the MCP server
metadata_json:
type: string
description: Additional metadata in JSON format
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-access-tokens
description: JWT authentication token. Obtain a token by calling the User API endpoint `/user/get-token-with-api-key` with your email and API key.