Connecting Claude and ChatGPT to the AsteriskRecipes MCP Server
Connecting Claude and ChatGPT to the AsteriskRecipes MCP Server
AsteriskRecipes.com runs a public, read-only MCP (Model Context Protocol) server at https://asteriskrecipes.com/mcp. It gives AI assistants direct, structured access to the site's reference library, applications, functions, AGI commands, AMI actions and events, and module configuration, instead of relying on whatever the model picked up during training (which is often outdated or wrong for a specific Asterisk version).
No API key, no account, no sign-up. It's rate-limited but otherwise open to anyone.
On this page
What it's for
Ask your assistant something like "what arguments does the Asterisk Dial() application take" or "which AMI events fire during a transfer," and instead of guessing, it can query this server for the current, correct answer sourced directly from the Asterisk project's own XML documentation.
This is a good fit for:
- Writing or debugging dialplan and needing accurate application/function signatures
- Checking whether an application or AMI action is available in a specific Asterisk version
- AGI/AMI development where argument order and event fields matter
- Any workflow where you're already using an AI assistant alongside Asterisk work
Connecting Claude Code
Claude Code can add a remote HTTP MCP server directly from the command line:
claude mcp add --transport http asteriskrecipes https://asteriskrecipes.com/mcp --scope user
--scope user makes the server available in every project on your machine, not just the one you're currently in. Verify the connection:
/mcp
You should see asteriskrecipes listed as connected.
If you'd rather hand-edit config instead of using the CLI, add this to ~/.claude.json (user scope) or your project's .mcp.json:
{
"mcpServers": {
"asteriskrecipes": {
"type": "http",
"url": "https://asteriskrecipes.com/mcp"
}
}
}
Connecting Claude Desktop or claude.ai
Custom remote connectors work the same way across claude.ai, Claude Desktop, and Cowork, since they all connect through Anthropic's cloud rather than your local machine.
- Go to Settings > Connectors
- Click Add custom connector
- Enter the server URL:
https://asteriskrecipes.com/mcp - Click Add. No OAuth client ID or secret is needed, this server has no authentication.
To use it in a conversation, click the + button in the chat input, choose Connectors, and toggle it on.
Team and Enterprise plans
An Owner has to add the connector at the organization level first (Organization settings > Connectors > Add > Custom > Web), after which individual members connect it themselves under Customize > Connectors.
Connecting ChatGPT
ChatGPT supports custom MCP connectors through Developer Mode (Pro, Team, Enterprise, and Edu plans):
- Settings > Connectors > Advanced, toggle Developer mode on
- In a chat, open the connectors menu and add a custom connector
- Enter the server URL:
https://asteriskrecipes.com/mcp
The server implements the search and fetch tool contract ChatGPT's connector UI requires, so it works without any extra configuration.
Available tools
| Tool | What it does |
|---|---|
search_reference |
Search the reference library by keyword. Returns matching entry titles, IDs, and short descriptions. |
get_reference_entry |
Fetch the full markdown content of one entry by category and slug. |
list_reference_categories |
List reference categories (applications, functions, AGI commands, AMI actions, AMI events, module configuration) with entry counts. |
compatibility_lookup |
List entries available as of a given Asterisk version, useful for checking whether something exists on an older install. |
search / fetch |
Fixed single-argument contract required by ChatGPT and similar connector UIs. Equivalent to search_reference and get_reference_entry under the hood. |
Example prompts
Once connected, you don't need to name the tools directly, just ask:
- "Look up the Asterisk
ConfBridgeapplication and summarize its arguments." - "What AMI events does a blind transfer generate?"
- "Is the
PJSIP_DIAL_CONTACTSfunction available in Asterisk 16?" - "List every AGI command related to call recording."
Scope and limits
This server is intentionally narrow:
- Read-only. No tool can create, edit, or delete anything. It queries the same published content the site renders publicly, nothing more.
- Reference section only. Snippets, scripts, and guides aren't exposed through this server (v1). Browse those on the site directly.
- Rate-limited. Fair-use limits apply per client, same as the rest of the site.
- No authentication required, none offered. There's nothing behind this server worth protecting with a login; it's the same content search engines already index.
Discovery for AI agents and crawlers
Agents that support machine-readable discovery don't need this guide at all. The server publishes:
- An MCP Server Card (draft SEP-2127) at
/mcp/server-card, linked from every page's<head>via<link rel="mcp-server-card"> - A domain-wide MCP catalog at
/.well-known/mcp/catalog.json - A mention in
llms.txtalongside the rest of the site's AI-facing metadata
What to read next
- Reference section to browse the same content the MCP server queries
- Getting Started with ARI if you're building something that talks to Asterisk programmatically
- The MCP specification for the underlying protocol
User Notes
Know a tip or gotcha for this topic? Share it below and help others.
Contribute a note
Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.