Dspy MCP Tool Integration Agent Skill
Use for MCP tools with DSPy, Model Context Protocol servers, dspy.Tool.from_mcp_tool, and ReAct agents over MCP-compatible tools.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/OmidZamani/dspy-skills --skill dspy-mcp-tool-integrationWhat comes with it
342 bytes besides the instructionThe instruction itself
8 sections, as written by the authorDSPy 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_itersand trace tool use in production.
Related Skills
- 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
Other skills for the same job
different authors, same section of the catalogue
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification
How to use it
Take omidzamani/dspy-mcp-tool-integration from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
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.
The instructions reference pip.
Without those the skill loads but fails at the first command.