> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morphic.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Overview

> Connect any AI agent to your Morphic CRM using the Model Context Protocol.

Morphic MCP is a [Model Context Protocol](https://modelcontextprotocol.io) server that gives AI agents direct access to your CRM — entities, activities, notes, knowledge base, and AI task suggestions.

**Endpoint:** `https://mcp.morphic.io/v1/mcp`

## What you can do

* **Query and mutate CRM data** — list, create, update, archive, and delete entities
* **Log interactions** — record emails, calls, meetings, and tasks against any entity
* **Semantic search** — find entities by concept using natural language
* **Knowledge base** — read and search workspace documents
* **AI task suggestions** — surface and accept AI-generated next actions

## Architecture

```
AI Agent (Claude Code / Cursor / Claude.ai / Hermes)
    │  Authorization: Bearer sk_live_xxx
    ▼
mcp.morphic.io  (Streamable HTTP MCP server)
    ├─ API key validation  →  Morphic backend (2-min cache)
    └─ 28 MCP tools
          │
          ▼
    api.morphic.io  (Morphic CRM backend)
```

**Transport:** Streamable HTTP MCP. Tool calls are `POST /v1/mcp` with `Content-Type: application/json`. SSE streaming is available via `GET /v1/mcp` with `Accept: text/event-stream`.

## Tools at a glance

<CardGroup cols={2}>
  <Card title="Schema Discovery" icon="magnifying-glass">
    `list_entity_types`, `get_entity_type_schema` — discover CRM schemas before querying
  </Card>

  <Card title="Entities (10 tools)" icon="database">
    Full CRUD: list, get, create, update, set field, link, unlink, search, archive, delete
  </Card>

  <Card title="Activities & Tasks (5 tools)" icon="check">
    Log emails, calls, meetings — create and manage tasks with due dates
  </Card>

  <Card title="Notes (4 tools)" icon="note-sticky">
    Create, update, delete markdown notes attached to any entity
  </Card>

  <Card title="Knowledge Base (4 tools)" icon="book">
    Browse folders, search documents, fetch content, get workspace AI context
  </Card>

  <Card title="Task Suggestions (2 tools)" icon="lightbulb">
    AI-generated next-action suggestions — list and accept them as real tasks
  </Card>
</CardGroup>
