mcp server.md
Finix MCP Server for AI Agents
MCP Server
The Finix MCP Server allows AI agents like Claude to search and retrieve information from Finix's documentation. Ask an AI agent questions about the Finix API to get accurate, current answers.
Before exploring setup, let’s clarify what MCP offers and why it’s essential for AI integration.
What is MCP?
Model Context Protocol (MCP) is an open standard enabling AI agents to connect to external data sources and tools. MCP lets AI models query live documentation, APIs, and databases in real time—instead of relying only on training data.
Why Use MCP?
Large language models have knowledge cutoffs and lack access to proprietary documentation. When you ask an AI agent about Finix APIs, it provides general guidance based on its training data.
MCP provides a standardized interface between AI agents and documentation servers. The Finix MCP server reveals all documentation—including guides, API references, and code examples—enabling AI agents to deliver accurate, up-to-date information on demand.
| Without MCP | With MCP |
|---|---|
| Responses based on training data | Responses based on live documentation |
| May be outdated or generic | Always reflects current API state |
| No access to Finix-specific examples | Full access to code samples and guides |
Quick Setup
Add the Finix MCP server to Claude Code with a single command:
claude mcp add finix-redocly-mcp https://docs.finix.com/mcp --transport http
That's it. Claude Code can now access Finix documentation.
Detailed Setup Guide
For step-by-step instructions, configuration options, and troubleshooting, see the Claude Code Setup Guide.
What You Can Do
Once connected, your AI agent can help you with:
Search Documentation
Ask questions in plain English and get answers from Finix documentation:
- "How do I process a refund with Finix?"
- "What parameters does the create payment endpoint accept?"
- "Show me an example of tokenizing a card."
Explore the API
Access details about Finix API endpoints: list all endpoints, view request and response schemas, check authentication requirements, and see code examples.
Understand Concepts
Explore Finix features and best practices, including the payment lifecycle and states, seller onboarding, fee collection options, and webhook integration.
Available Tools
The MCP server offers your AI agent these tools:
| MCP Tool | Tool Description |
|---|---|
search |
Search across all Finix documentation using keywords or phrases. |
list-apis |
List available APIs with their context and purpose. |
get-endpoints |
Get all endpoints for a specific API. |
get-endpoint-info |
Get comprehensive details about a specific endpoint including parameters, security requirements, and examples. |
get-security-schemes |
Get authentication and security information for an API. |
get-full-spec-document |
Retrieve the complete OpenAPI specification. |
Example Usage
Here are some example prompts you can use with your AI agent after connecting the Finix MCP server:
Getting Started
"I'm new to Finix. What's the basic flow for accepting an online payment?"
API Reference
"What fields are required when creating a Transfer resource?"
Integration Help
"How do I set up webhooks to track payment status changes?"
Troubleshooting
"What does the RETURNED state mean for a Transfer?"
Requirements
- Claude Code (or another MCP-compatible AI agent).
- Internet connection to reach docs.finix.com.
How It Works
- Ask a question about Finix in your AI agent.
- The AI detects the need for Finix-specific info.
- It queries the MCP server at
https://docs.finix.com/mcp. - The server searches Finix documentation.
- Results are returned to the AI.
- You receive an accurate, up-to-date response.
The process takes just seconds and keeps you in your development environment.
Learn More
Connect ChatGPT to Finix MCP Connect ChatGPT to the Finix MCP server and ask questions about Finix to get accurate, up-to-date answers sourced directly from the documentation.
Connect Claude to Finix MCP Use Claude Code with Finix MCP to ask questions about Finix APIs and get documentation-based answers.
Connect Gemini to Finix MCP Connect the Gemini CLI to the Finix MCP server and ask questions about Finix to get answers from the documentation.
Connect Cursor to Finix MCP Connect Cursor to the Finix MCP server and ask questions about Finix to get accurate answers from the documentation inside your editor.
Model Context Protocol Learn more about the open MCP standard and specification.