# Finix MCP Server for AI Assistants

Give your AI assistant direct access to Finix documentation.

The Finix MCP Server lets AI assistants like Claude search and retrieve information from Finix's published documentation. This means you can ask your AI coding assistant questions about the Finix API and get accurate, up-to-date answers.

![MCP Server](/assets/developers.717dae32ca9ed1ff6b32b4cacfc00815e1869cb038a419bb9c91a8d3f1c44628.fec90461.svg)

## What is MCP?

**Model Context Protocol (MCP)** is an open standard that enables AI assistants to connect to external data sources and tools. Rather than relying solely on training data, MCP allows AI models to query live documentation, APIs, and databases in real time.

### Why Use MCP?

Large language models have knowledge cutoffs and lack access to proprietary documentation. When you ask an AI assistant about Finix-specific APIs, it can only provide general guidance based on its training data.

MCP solves this by establishing a standardized interface between AI assistants and documentation servers. The Finix MCP server exposes our complete documentation—guides, API references, and code examples—allowing AI assistants to retrieve accurate, current 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:


```bash Add Finix MCP Server
claude mcp add finix-redocly-mcp https://docs.finix.com/mcp --transport http
```

That's it. Claude Code can now search and retrieve information from Finix documentation.

Detailed Setup Guide
For step-by-step instructions, configuration options, and troubleshooting, see the [Claude Code Setup Guide](/additional-resources/developers/mcp-claude-setup).

## What You Can Do

Once connected, your AI assistant 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

Get detailed information about Finix API endpoints:

- List all available endpoints
- View request/response schemas
- See authentication requirements
- Get code examples


### Understand Concepts

Learn about Finix features and best practices:

- Payment lifecycle and states
- Seller onboarding process
- Fee collection options
- Webhook integration


## Available Tools

The MCP server provides these capabilities to your AI assistant:

| 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 assistant 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 PENDING state mean for a Transfer?"


## Requirements

- **Claude Code** (or another MCP-compatible AI assistant)
- Internet connection to reach `docs.finix.com`


## How It Works

1. **You ask a question** about Finix in your AI assistant
2. **The AI recognizes** it needs Finix-specific information
3. **It queries the MCP server** at `docs.finix.com/mcp`
4. **The server searches** Finix's published documentation
5. **Results are returned** to the AI, which formulates an answer
6. **You get an accurate response** based on current Finix documentation


The entire process happens in seconds, and you don't need to leave your development environment.

## Learn More

Claude Code Setup
Step-by-step guide to connect Claude Code to the Finix MCP server.

Model Context Protocol
Learn more about the open MCP standard and specification.

Finix API Reference
Browse the complete Finix API documentation directly.