How to Use the Knoema MCP in LangChain

Q: How do I build a LangChain agent to search for Knoema datasets?

First, get the Knoema tools by calling client.gettools() from the MCP adapter. Then, pass that tool list into a LangChain agent constructor like createagent. The agent will automatically know how to use searchdatasets and other tools based on their schemas.

Q: Can my LangChain agent handle different data units from Knoema?

Yes. You can build a chain where the agent first calls listdataunits for a given dataset. It can then use the output to normalize the numbers or flag inconsistencies before passing the data to the next step in the chain.

Q: What's the best way to get the latest Knoema data with LangChain?

Use the getlatestdatasetdata tool. A simple chain can be set up to run on a schedule, call this tool for a specific dataset ID, and then trigger other actions based on whether new data was returned.

Build data analysis chains with LangChain to query Knoema's global economic stats. Your agent decides the next step.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Knoema MCP to LangChain

Create your Vinkius account to connect Knoema 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 Knoema with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find and Prep Datasets in a Chain

This isn't about just one tool call. A LangChain agent can run a sequence to get the job done. It starts with `search_datasets` to find the right dataset ID for, say, unemployment figures. Then it automatically pipes that ID into `get_dataset_metadata` to check the data's structure and source. Once the agent has the metadata, it can make another call to `list_dataset_regions` to see which countries are covered. This whole discovery process happens in a single, observable chain, so you see exactly how your agent found the data it needed. No guesswork.

Automate Multi-Step Data Extraction

Give your agent a high-level goal like "get inflation data for Germany." The agent can then use `search_data_series` to find the specific series mnemonics for German CPI. The key is what happens next: LangChain feeds those mnemonics directly into a `get_data_series` call to pull the raw numbers. The output of one tool becomes the input for the next. You're not manually copying and pasting IDs or mnemonics between calls. You're building a real pipeline that connects Knoema's tools together to execute a complex query.

Build Economic Monitors with this MCP Server

Use LangChain to build an agent that watches economic indicators for you. You can set up a recurring chain that kicks off every morning. The first step uses `get_latest_dataset_data` to see if new GDP or trade balance figures were posted overnight. If new data exists, the chain can trigger another tool call to `get_data_series` to pull a year's worth of historical context. Your agent then compares the new point to the old trend and flags any big changes. This is how you automate monitoring with an MCP server instead of just fetching data on command.

Setup guide

Set up Knoema 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 Knoema 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({
    "knoema-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 Knoema 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 Knoema. 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 Knoema 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 Knoema MCP in LangChain

First, get the Knoema tools by calling `client.get_tools()` from the MCP adapter. Then, pass that tool list into a LangChain agent constructor like `create_agent`. The agent will automatically know how to use `search_datasets` and other tools based on their schemas.

Yes. You can build a chain where the agent first calls `list_data_units` for a given dataset. It can then use the output to normalize the numbers or flag inconsistencies before passing the data to the next step in the chain.

Use the `get_latest_dataset_data` tool. A simple chain can be set up to run on a schedule, call this tool for a specific dataset ID, and then trigger other actions based on whether new data was returned.

Yes, it works perfectly. Since every tool call is a standard part of a chain, LangSmith will trace every interaction with the Knoema server. You'll see the inputs, outputs, latency, and token usage for each call to tools like `get_data_series`.

The server only processes the specific dataset IDs, search terms, and series mnemonics your LangChain agent sends with each tool call. All connections are ephemeral and your query history for economic data isn't stored by Vinkius. It's a pass-through.

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