Problem
Grinta supports MCP (Model Context Protocol) servers, but there's no guide explaining
how to connect a custom MCP server or build one that works with Grinta.
Proposed solution
Add a docs/MCP_INTEGRATION.md guide covering:
- What MCP is — brief explanation with link to the spec
- Connecting an existing MCP server — configuration in
grinta.toml
- Building a custom MCP server — minimal example (e.g., a server that exposes
a database query tool)
- Testing the integration — how to verify tools are discovered and callable
- Troubleshooting — common issues (auth, transport, tool schema validation)
Include a working example in examples/custom-mcp-server/ with:
- A minimal Python MCP server (~50 lines)
- A
grinta.toml snippet to connect it
- A test task that uses the custom tool
Acceptance criteria
Problem
Grinta supports MCP (Model Context Protocol) servers, but there's no guide explaining
how to connect a custom MCP server or build one that works with Grinta.
Proposed solution
Add a
docs/MCP_INTEGRATION.mdguide covering:grinta.tomla database query tool)
Include a working example in
examples/custom-mcp-server/with:grinta.tomlsnippet to connect itAcceptance criteria
docs/MCP_INTEGRATION.mdwritten and linked from main READMEexamples/custom-mcp-server/