omidzamani/dspy-mcp-tool-integration
skills/dspy-mcp-tool-integration/SKILL.md
This skill should be used when the user asks to "use MCP tools with DSPy", "connect an MCP server to ReAct", "convert MCP tools to DSPy tools", mentions Model Context Protocol, `dspy.Tool.from_mcp_tool`, streamable HTTP MCP transport, stdio MCP servers, or needs to expose MCP-compatible tools to a DSPy agent.
$ install --global
skillsauthnpx skillsauth add omidzamani/dspy-skills dspy-mcp-tool-integrationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 3, 2026, 3:11 AM18.5s1 file scanned
SKILL.md
- name:
- dspy-mcp-tool-integration
- version:
- 2.0.0
- dspy-compatibility:
- 3.2.1
- description:
- This skill should be used when the user asks to "use MCP tools with DSPy", "connect an MCP server to ReAct", "convert MCP tools to DSPy tools", mentions Model Context Protocol, `dspy.Tool.from_mcp_tool`, streamable HTTP MCP transport, stdio MCP servers, or needs to expose MCP-compatible tools to a DSPy agent.
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_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
Related Skills
omidzamani/dspy-simba-optimizer
tools
VerifiedTrustedCommunity
This skill should be used when the user asks to "optimize with SIMBA", "use mini-batch introspective optimization", "generate self-reflective rules", mentions "SIMBA optimizer", "stochastic mini-batch ascent", "output variability", or needs an alternative to MIPROv2/GEPA that evolves rules and demonstrations from numeric metrics.
78SKILL.mdUpdated Jun 3, 2026
omidzamani/dspy-signature-designer
data-ai
VerifiedTrustedCommunity
This skill should be used when the user asks to "create a DSPy signature", "define inputs and outputs", "design a signature", "use InputField or OutputField", "add type hints to DSPy", mentions "signature class", "type-safe DSPy", "Pydantic models in DSPy", or needs to define what a DSPy module should do with structured inputs and outputs.
78SKILL.mdUpdated Jun 3, 2026
omidzamani/dspy-reasoning-modules
development
VerifiedTrustedCommunity
This skill should be used when the user asks to "use DSPy RLM", "process a very long context", "use ProgramOfThought", "use CodeAct", "run DSPy modules in parallel", mentions Recursive Language Models, sandboxed Python execution, Deno, `dspy.RLM`, `dspy.ProgramOfThought`, `dspy.CodeAct`, or `dspy.Parallel`, or needs to choose a DSPy reasoning module beyond Predict, ChainOfThought, and ReAct.
78SKILL.mdUpdated Jun 3, 2026
omidzamani/dspy-react-agent-builder
tools
VerifiedTrustedCommunity
This skill should be used when the user asks to "create a ReAct agent", "build an agent with tools", "implement tool-calling agent", "use dspy.ReAct", mentions "agent with tools", "reasoning and acting", "multi-step agent", "agent optimization with GEPA", or needs to build production agents that use tools to solve complex tasks.
78SKILL.mdUpdated Jun 3, 2026