> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/2026-09-11-mcp-knowledge-sources/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# MCP: create knowledge sources and file articles into them

An AI assistant connected over the MCP server can now create a knowledge source and file the articles it writes into that source. A batch of imported documents then appears on the Knowledge page as one source instead of loose articles under **Created in Ada**.

## What's new

* **Create a source**: [`edit_agent_config`](/mcp/tools/edit-agent-config) accepts a `knowledge_source` entity with `name`, optional `external_id`, and optional `metadata`. Create only; rename and delete stay in the Knowledge API.
* **List sources**: [`list_entities`](/mcp/tools/list-entities) accepts `entity_type='knowledge_sources'` and returns each source's Ada `id`, Knowledge API `external_id`, and deletion `status`.
* **File an article into a source**: [`edit_agent_behavior`](/mcp/tools/edit-agent-behavior) accepts `knowledge_source_id` on knowledge article `created` and `modified` changes. Sources that hold imported articles, are managed by an integration, are a website import, or are being deleted are refused.
* **Dashboard keeps Edit and Delete**: articles written in Ada stay editable in the dashboard whichever source they are filed under, and saving one no longer moves it back to **Created in Ada**.