How to Use the Franchimp MCP in LangChain

Q: Can my LangChain agent track Franchimp usage costs?

Yes. Have your agent call listavailablecredits at the start of the chain. It can conditionally halt execution if your document credits drop below a specific threshold.

Q: How do I handle large FDD document lists with Franchimp and LangChain?

Build a paginated loop in your LangGraph setup. Call listfdddocuments in batches so you don't blow out the context window of your LLM.

Build automated franchise research pipelines with LangChain. Chain document lookups directly into lead generation workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Franchimp MCP to LangChain

Create your Vinkius account to connect Franchimp to LangChain and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Franchimp with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

LangChain MCP Server Pipelines

The `search_franchisors` tool feeds directly into your ReAct agent's decision loop. You pass a market category, and your LangChain agent pulls the matching franchisors to start the pipeline. Next, the agent routes those results into `get_investment_stats`. You get an exact breakdown of capital requirements and historical performance. LangSmith logs every token spent during this multi-step extraction.

Multi-Unit Operator Extraction

The `list_multi_unit_operators` tool gives your chain a list of high-value targets. You don't have to guess who owns what. The agent reads the list and immediately triggers contact lookups. That output gets piped straight to `get_franchisee_details`. Your MCP Server script compiles the contact info, checks `list_available_credits` to manage your API spend, and formats a clean lead list for your sales team.

FDD Document Audits

The `list_fdd_documents` tool pulls disclosure records into your document processing chain. You can feed these raw filings into a summarization agent to catch red flags before a deal closes. If a specific filing looks suspicious, the agent fires off `get_fdd_metadata` for the exact registration dates. Your pipeline builds a timeline of the brand's legal history without a human ever opening a PDF.

Setup guide

Set up Franchimp MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Franchimp tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "franchimp-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Franchimp transactions"
    })
    print(result["messages"][-1].content)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Franchimp. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Franchimp now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Franchimp MCP in LangChain

Use the langchain-mcp-adapters package. You instantiate MultiServerMCPClient with your HTTP transport URL and call get_tools() to arm your ReAct agent.

Yes. Have your agent call list_available_credits at the start of the chain. It can conditionally halt execution if your document credits drop below a specific threshold.

You might be passing the wrong parameter types between steps. Check your LangSmith traces to ensure the output from list_franchises matches the expected input format for the operator lookup.

Build a paginated loop in your LangGraph setup. Call list_fdd_documents in batches so you don't blow out the context window of your LLM.

Franchimp processes franchisor metadata and franchisee contact details. The Vinkius V8 Isolate Sandbox destroys the environment the millisecond your LangChain process ends, leaving zero trace of your queries.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript