mcpbeat

Dspy MCP Tool Integration

omidzamani/dspy-mcp-tool-integration

Use for MCP tools with DSPy, Model Context Protocol servers, dspy.Tool.from_mcp_tool, and ReAct agents over MCP-compatible tools.

836 tokens
context cost
the whole folder, loaded on every use
2
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
119
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/OmidZamani/dspy-skills --skill dspy-mcp-tool-integration

What comes with it

342 bytes besides the instruction
example.py

The instruction itself

8 sections, as written by the author

DSPy MCP Tool Integration

Goal

Connect an MCP server with the MCP Python client, convert its tools to dspy.Tool, and use them in an async DSPy agent.

Install

pip install -U "dspy[mcp]>=3.2.1,<3.3"

DSPy converts tools but does not manage MCP connections. Keep the ClientSession alive for as long as the DSPy tools are in use.

Streamable HTTP Server

import asyncio
import dspy
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client("http://localhost:8000/mcp") as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            response = await session.list_tools()
            tools = [dspy.Tool.from_mcp_tool(session, tool) for tool in response.tools]

            agent = dspy.ReAct("task -> result", tools=tools, max_iters=5)
            output = await agent.acall(task="Check the weather in Tokyo")
            print(output.result)

asyncio.run(main())

Local Stdio Server

import asyncio
import dspy
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    params = StdioServerParameters(
        command="python3",
        args=["path/to/server.py"],
        env=None,
    )

    async with stdio_client(params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            response = await session.list_tools()
            tools = [dspy.Tool.from_mcp_tool(session, tool) for tool in response.tools]
            agent = dspy.ReAct("question -> answer", tools=tools, max_iters=5)
            print((await agent.acall(question="What is 25 + 17?")).answer)

asyncio.run(main())

Best Practices

  • Use acall() because MCP tools are asynchronous.
  • Initialize the session before listing tools.
  • Keep tool descriptions precise at the MCP server boundary.
  • Apply authentication and authorization before exposing sensitive tools.
  • Set a modest max_iters and trace tool use in production.
  • Build agents: dspy-react-agent-builder
  • Configure native function calling: dspy-adapters-multimodal
  • Add async runtime patterns: dspy-production-deployment

Official Documentation

  • DSPy MCP guide: https://dspy.ai/learn/programming/mcp/
  • DSPy MCP tutorial: https://dspy.ai/tutorials/mcp/
  • MCP Python SDK: https://github.com/modelcontextprotocol/python-sdk

How to use it

Copy the folder

Take omidzamani/dspy-mcp-tool-integration from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference pip. Without those the skill loads but fails at the first command.