AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

mcp-builder

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), Node/TypeScript (MCP SDK), or C#/.NET (Microsoft MCP SDK).

Original source
microsoft
License
MIT
Pinned revision
3f5b461b2314e01c400564051e92469114c5b68f

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read microsoft--mcp-builder at revision 3f5b461b2314e01c400564051e92469114c5b68f, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 6

reference/python_mcp_server.md · 24000

t/JSON returns

  • [ ] Pydantic models handle input validation (no manual validation needed)

Advanced Features (where applicable)

  • [ ] Context injection used for logging, progress, or elicitation
  • [ ] Resources registered for appropriate data endpoints
  • [ ] Lifespan management implemented for persistent connections
  • [ ] Structured output types used (TypedDict, Pydantic models)
  • [ ] Appropriate transport configured (stdio or streamable HTTP)

Code Quality

  • [ ] File includes proper imports including Pydantic imports
  • [ ] Pagination is properly implemented where applicable
  • [ ] Filtering options are provided for potentially large result sets
  • [ ] All async functions are properly defined with async def
  • [ ] HTTP client usage follows async patterns with proper context managers
  • [ ] Type hints are used throughout the code
  • [ ] Constants are defined at module level in UPPER_CASE

Testing

  • [ ] Server runs successfully: python your_server.py --help
  • [ ] All imports resolve correctly
  • [ ] Sample tool calls work as expected
  • [ ] Error scenarios handled gracefully

Related Resources

Other Language Guides

Microsoft-Specific Patterns

If building MCP servers for Azure services or integrating with Foundry Agent Service, see Microsoft MCP Patterns for:

  • Azure Functions remote MCP deployment
  • Entra ID authentication patterns
  • Tool approval and Agent Service integration
  • C# command implementation patterns