How to Use the BLS Jobs — Nonfarm Payrolls & Wages MCP in LangChain

Q: How does LangChain handle the payload from the BLS Jobs — Nonfarm Payrolls & Wages tool?

LangChain receives the raw JSON response from getnonfarmpayrolls directly into the agent's state. The agent parses the CES0000000001 series data and uses it as input for subsequent chain steps.

Q: Can I trace BLS Jobs — Nonfarm Payrolls & Wages queries using LangSmith?

Yes, every call to querybls is fully tracked within LangSmith. You can monitor the precise latency, input series IDs, and token usage of your payroll data queries.

Q: What is the limit for concurrent series queries in LangChain?

The querybls tool allows up to 50 concurrent series lookbacks per call. Your LangChain agent can fetch multiple employment metrics, like average hourly earnings and private sector jobs, in one go.

Get raw BLS payroll metrics directly into your LangChain decision loops to forecast Fed rate moves.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BLS Jobs — Nonfarm Payrolls & Wages MCP to LangChain

Create your Vinkius account to connect BLS Jobs — Nonfarm Payrolls & Wages 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 BLS Jobs — Nonfarm Payrolls & Wages with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Feed BLS payroll data directly into your LangChain loops

The `get_nonfarm_payrolls` tool pulls raw CES0000000001 employment data straight into your agent's active memory context. Your LangChain agent reads the latest payroll numbers and immediately feeds them into the next step of your chain, bypassing manual CSV exports. LangSmith tracks every token of the raw employment payload as it moves from the API to your agent. You'll see exactly how the agent parses the employment metrics before it decides to run a follow-up query.

Run complex BLS series queries in LangChain chains

The `query_bls` tool lets your agent inspect up to 50 concurrent series IDs simultaneously. LangChain manages the state of these parallel lookbacks, letting your agent compare wage growth against payroll trends in a single execution step. Because the MCP Server exposes these granular endpoints directly, your agent evaluates complex historical patterns without losing context between chain steps. You monitor the latency of these bulk requests in your LangSmith dashboard to keep your pipelines fast.

Multi-tool chains for Federal Reserve rate forecasting

The `get_nonfarm_payrolls` tool serves as the initial trigger for your multi-step financial reasoning pipelines. Your agent grabs the latest payroll delta, flags whether it beats expectations, and immediately passes that output to your valuation chains. By combining this specialized MCP Server with your existing database tools, you build autonomous workflows that react to macroeconomic shifts. The agent decides when to pull payroll history and when to query interest rate models based on real-time BLS updates.

Setup guide

Set up BLS Jobs — Nonfarm Payrolls & Wages 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 BLS Jobs — Nonfarm Payrolls & Wages 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({
    "bls-jobs-nonfarm-payrolls-wages-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 BLS Jobs — Nonfarm Payrolls & Wages 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 Bureau of Labor Statistics. 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 BLS Jobs — Nonfarm Payrolls & Wages 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 BLS Jobs — Nonfarm Payrolls & Wages MCP in LangChain

LangChain receives the raw JSON response from `get_nonfarm_payrolls` directly into the agent's state. The agent parses the CES0000000001 series data and uses it as input for subsequent chain steps.

Yes, every call to `query_bls` is fully tracked within LangSmith. You can monitor the precise latency, input series IDs, and token usage of your payroll data queries.

Use MultiServerMCPClient pointing to the Vinkius endpoint, then call client.get_tools() to pass the payroll tools to your agent. This lets your graph-based agents call `get_nonfarm_payrolls` dynamically.

The `query_bls` tool allows up to 50 concurrent series lookbacks per call. Your LangChain agent can fetch multiple employment metrics, like average hourly earnings and private sector jobs, in one go.

Vinkius hosts the server in a zero-trust, ephemeral V8 Isolate sandbox. Your specific BLS Series IDs and query parameters never persist on disk, protecting your proprietary economic research templates.

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