# Enso MCP Server

> Hosted Model Context Protocol (MCP) server providing AI agents direct tool execution capabilities against Enso workspaces.

## System Summary
- **MCP Endpoint**: https://mcp.getenso.ai/mcp
- **Transport Protocol**: Streamable HTTP (JSON-RPC 2.0)
- **Specification Version**: 2024-11-05
- **OAuth Server Metadata**: https://mcp.getenso.ai/.well-known/oauth-authorization-server

## Tool Modules Available
1. **Contracts** (4 tools): `get_contract`, `draft_contract`, `update_contract_job`, `finalize_contract`
2. **Invoices** (7 tools): `create_manual_invoice`, `add_invoice_item`, `update_invoice_item`, `delete_invoice_item`, `create_payment`, `update_payment`, `delete_payment`
3. **Metering** (6 tools): `create_event`, `create_meter`, `update_meter`, `delete_meter`, `sync_meter`, `sync_all_meters`
4. **Customers** (5 tools): `create_customer`, `update_customer`, `delete_customer`, `update_entity`, `create_org_entity`
5. **Catalog** (4 tools): `list_sku_groups`, `create_sku`, `update_sku`, `delete_sku`
6. **Masters** (5 tools): `list_currencies`, `list_units`, `list_countries`, `list_states`, `list_payment_sources`
7. **FSM Actions** (7 tools): `fsm_get_actions`, `fsm_get_bulk_actions`, `fsm_get_states`, `fsm_get_graph`, `fsm_transition`, `fsm_bulk_transition`, `fsm_undo_transition`
8. **Objects** (2 tools): `get_object_schema`, `query_objects`
9. **Settings** (5 tools): `list_org_templates`, `get_invoice_template_html`, `create_invoice_template`, `update_invoice_template`, `get_plan_types`

## Authentication
Supports OAuth 2.0 Authorization Code Grant with PKCE, or Header Authentication (`Authorization: Bearer <token>`).

## Documentation
Full API reference: https://docs.getenso.ai