Search documentation
Fuzzy search across every docs page and section
PlatformMCP and AI agents
Fuzzy search across every docs page and section
PlatformMCP and AI agents
Platform
Connect AI agents to FeelConnect over the Model Context Protocol: the /api/mcp endpoint, available tools, and key-based authorization.
FeelConnect ships a Model Context Protocol (MCP) server so agents — Claude, IDE assistants, and your own — can call the platform as tools instead of hand-writing HTTP. The server exposes the same data and AI products as /v1, with the same key-based authorization and metering.
/api/mcpTransport is Streamable HTTP per the MCP specification. Authorize with a normal secret key; the key's environment decides whether tools touch sandbox or live data — point agents at fc_sk_test_ keys unless you know exactly what you are doing.
claude mcp add feelconnect https://api.feelconnect.dev/api/mcp \--transport http \--header "Authorization: Bearer fc_sk_test_..."
| Tool | Maps to | Description |
|---|---|---|
search_institutions | /v1/institutions/search | Find institutions by name and type. |
create_link_url | /v1/link/token/create | Hosted Link URL for a human to complete in a browser. |
exchange_public_token | /v1/link/token/exchange | public_token → permanent access_token. |
get_item | /v1/items/get | Item status and consented products for an access token. |
list_accounts | /v1/accounts/get | Accounts with balances. |
get_transactions | /v1/transactions/get | Date-ranged transactions, up to 250 per call. |
sync_transactions | /v1/transactions/sync | Cursor-paged transaction changes. |
get_recurring | /v1/recurring/get | Recurring streams and subscriptions. |
get_investments | /v1/investments/holdings/get | Holdings with securities. |
get_liabilities | /v1/liabilities/get | Loan terms and APRs. |
ai_categorize | /v1/ai/categorize | Categorize raw transactions. |
ai_cashflow_forecast | /v1/ai/cashflow | Daily cash-flow projection. |
ai_health_score | /v1/ai/health-score | Explainable financial health score. |
ai_financial_summary | /v1/ai/financial-summary | Narrative summary of the last 30 days. |
ai_purchase_analysis | /v1/ai/purchase-analysis | Buy, wait, or skip — with opportunity cost. |
Tools that read item data take an access_token argument, exactly like the REST endpoints. The server never mints tokens without a human: create_link_url returns a URL the person opens themselves, so credentials and consent stay in the Link flow.
Authorization: Bearer fc_sk_… header on the MCP connection scopes every tool call to your application and environment./llms.txt — a machine-readable map of these docs for LLM crawlers; /llms-full.txt is the endpoint-by-endpoint expansion./openapi.json — the complete OpenAPI 3.1 description of /v1, including the webhook payloads./.well-known/mcp.json — the MCP discovery descriptor: endpoint, transport, auth, and every tool with its arguments./.well-known/ai-plugin.json — the agent manifest (what this API returns, and how to authenticate).GET to the MCP endpoint returns the same descriptor, so probing the URL answers rather than 405s.