# Shaped MCP Server

MCP (Model Context Protocol) server that exposes Shaped's API to AI agents. Enables Cursor, Claude Desktop, and other MCP clients to create and manage tables, views, engines, and run queries.

## Quick Start

1. Install: `pip install -e .` (from this directory) or `pip install shaped-mcp` (PyPI).
2. Set `SHAPED_API_KEY` in your environment.
3. Configure your AI tool (see [Usage Guide](../../docs/mcp-usage.md)).
4. Run tests: `pytest mcp/tests/` (with `pip install -e ".[dev]"`).

## Documentation

- **[Build Plan](PLAN.md)** – Implementation plan, tools, and phases.
- **[Usage Guide](../../docs/mcp-usage.md)** – How to configure Cursor, Claude, and other MCP clients.

## Status

Phase 1–3 implemented: STDIO, HTTP (Streamable), Bearer auth, prompts, Helm chart, PyPI publish, deploy workflow. See `PLAN.md` for full roadmap. For local Cursor testing, copy `.cursor/mcp.json.example` to `.cursor/mcp.json` and set `SHAPED_API_KEY`. To list in the [MCP Registry](https://registry.modelcontextprotocol.io/), use `registry-entry.md`.
