Connect to the MCP Server

AI and LLM Tools

Overview

Infinicept's Developer Documentation Model Context Protocol (MCP) server enables your agentic AI/LLM tools like Claude, Claude Code, ChatGPT, Gemini, and others, to interact directly with Infinicept's API Reference. It can look up API specs, pull endpoint details, and help generate code to streamline your integration with natural-language prompts.

This is just the first of Infinicept's MCP offerings. Stay tuned for more information coming soon.


MCP Server Tools

Example promptInvoked toolWhat it does
"What APIs are available in the Infinicept developer docs?"list-specsLists every API spec in the project along with its title
"Show me all the endpoints in the Backoffice API."list-endpointsReturns all API paths and HTTP methods, each with a short summary
"Give me the full details on the GET endpoint for reviewing paginated transactions."get-endpointReturns everything about a specific endpoint: description, parameters, and security requirements
"Search the API docs for anything related to funding or deposits."search-specsCase-insensitive search across all paths, operations, and schemas


Connecting to the MCP Server

ℹ️

By connecting to the Developer Documentation MCP server, your use of it complies with your organization's AI and security policies. Share this page with your AI/LLM tool administrator so they can assist you with the steps below. NOTE: AI tools are rapidly evolving. Connection requirements per tool may change over time.

The Developer Documentation MCP server is available at https://developer.infinicept.com/mcp. Select a tab below for instructions to connect your preferred AI agent to this server:

Option 1: Add Custom Integration (paid plans)

  1. Go to Settings → Integrations
  2. Click "+ Add Custom Integration"
  3. Enter Infinicept as the name
  4. Enter https://developer.infinicept.com/mcp as the URL
  5. Click Add

Option 2: Edit config file (free tier)

Add to claude_desktop_config.json:

  {
    "mcpServers": {
      "infinicept": {
        "url": "https://developer.infinicept.com/mcp"
      }
    }
  }

ℹ️ Config file locations: On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%\Claude\claude_desktop_config.json. Restart Claude Desktop after saving.



Try It Now: Your First Query in Under 2 Minutes

Once you've connected to the MCP server using the instructions above, try this quick workflow to confirm everything is working and see the tools in action.


Step 1: Open your AI assistant (Claude, Claude Code, ChatGPT, Gemini, etc.) and start a new chat.


Step 2: Ask your AI what APIs are available.

Use Infinicept's documentation to list all available API specs.

You should see a response listing Infinicept's API specifications for New Accounts, Backoffice, and Orchestrate. This confirms the list-specs tool is connected and working.


Step 3: Explore an endpoint.

Use Infinicept's documentation to show me the full details on the GET endpoint for reviewing paginated transactions.

The response should return details including the endpoint path, parameters, authentication requirements, and a description all pulled directly from the live API specification.


Step 4: Generate a code snippet.

Use Infinicept's documentation to generate a Python code snippet for reviewing paginated transactions via the Backoffice API.

You should receive a working code snippet you can copy directly into your project.


If you received responses at each step, your MCP connection is ready to use. Try asking your own questions about the New Accounts or Backoffice API.


⚠️

Not seeing results? Make sure you reference "Infinicept's documentation" in your prompts, especially if you have multiple MCP servers installed.



More Example Outputs

Wondering what to expect? Here's what responses from the MCP server look like in practice:

ℹ️

The following are example responses from Claude Desktop. Actual responses will vary slightly depending on which AI/LLM tool you use and how you phrase your prompt.


Exploring webhooks


Prompt:

Use Infinicept's documentation to show me what webhook events are available with Backoffice.

What AI returns:

The Infinicept Backoffice API supports webhook subscriptions for key funding lifecycle events. Use the type field in your Subscribe to a Webhook request to specify which event you want to receive notifications for.

Webhook Event Types

Type ValueEvent NameDescription
5Submerchant Deposit RejectedTriggered when a submerchant deposit has been rejected.
6Funding Deposit FundedTriggered when a funding deposit has been successfully funded.
7Funding Deposit RejectedTriggered when a funding deposit has been rejected.
8Funding Deposit Partially RejectedTriggered when a funding deposit has been partially rejected.

Example

To subscribe to the Funding Deposit Rejected webhook, pass 7 as the type value in the request body:

{
  "type": 7,
  "destinationURL": "https://your-domain.com/webhooks/funding-deposit-rejected",
  "authenticationMethod": {
    "method": 0,
    "username": "your-username",
    "password": "your-password"
  }
}


Getting endpoint details


Prompt:

Use Infinicept's documentation to give me the full details on the GET endpoint for reviewing paginated transactions.

What AI returns:

GET /{tenantId}/transactions/paginated

Authentication — requires x-AuthenticationKeyId and x-AuthenticationKeyValue headers.

Key query parameters include:

ParameterTypeDescription
SubmerchantIdintegerFilter by one or more submerchant IDs
TransactionTypestringFilter by type: Deposit, Refund, Chargeback, etc.
FundingStatusstringFilter by status: New, Submitted, Funded, Held, etc.
DateFilterstringAll, Today, Yesterday, ThisWeek, DateRange, etc.
FromDate / ToDatedate-timeRequired when DateFilter is set to DateRange
CurrentPageintegerPage number for pagination
PageSizeintegerResults per page (1–1000, default 1000)

The response returns a transactions array with fields like id, transactionAmount, netAmount, fundingStatus, settlementDate, submerchantName, and more — along with pagination metadata (totalRequestedTransactions, currentPage, totalPages).



Generating a code snippet


Prompt:

Use Infinicept's documentation to generate a Python code snippet for retrieving paginated transactions via the Backoffice API.

What AI returns:

Here's a Python snippet for retrieving paginated transactions you can paste into your own environment.

import requests

url = "https://api.infinicept.com/api/{tenantId}/transactions/paginated"

headers = {
    "accept": "application/json",
    "x-AuthenticationKeyId": "YOUR_KEY_ID",
    "x-AuthenticationKeyValue": "YOUR_KEY_VALUE"
}

params = {
    "DateFilter": "ThisMonth",
    "PageSize": 100,
    "CurrentPage": 1
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

Support

💬 Have a question? Contact us on the Customer Support Portal.

🔹 Learn about updates in our Changelog.


Did this page help you?