Schema | Semantic API

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`SEMANTIC_API_KEY`	Yes	Your Semantic API key
`SEMANTIC_API_URL`	No	API base URL override	https://semanticapi.dev

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Tools

Functions exposed to the LLM to take actions

Name Description

Name	Description
semantic_query	Search for an API capability using natural language. `Returns endpoint details, parameters, auth info, and code snippets. Args: query: Natural language description of what you want to do (e.g. "send an email with Gmail") auto_discover: Whether to automatically discover new APIs if no cached result exists`
semantic_discover	Deep discovery of a specific provider/API by name and intent. `Args: provider_name: Name of the API provider (e.g. "stripe", "twilio", "github") user_intent: Optional description of what you want to do with this API`
semantic_discover_url	Analyze any API from its documentation URL. Generates a full provider config. `Args: url: URL of the API documentation to analyze user_intent: Optional description of what you want to do with this API`

semantic_query

Search for an API capability using natural language.

Returns endpoint details, parameters, auth info, and code snippets.

Args:
    query: Natural language description of what you want to do (e.g. "send an email with Gmail")
    auto_discover: Whether to automatically discover new APIs if no cached result exists

semantic_discover

Deep discovery of a specific provider/API by name and intent.

Args:
    provider_name: Name of the API provider (e.g. "stripe", "twilio", "github")
    user_intent: Optional description of what you want to do with this API

semantic_discover_url

Analyze any API from its documentation URL. Generates a full provider config.

Args:
    url: URL of the API documentation to analyze
    user_intent: Optional description of what you want to do with this API

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

Semantic API

Server Configuration

Capabilities

Tools

Prompts

Resources

Latest Blog Posts

MCP directory API