KnowMapped MCP
Connect AI assistants to KnowMapped to create, retrieve, and edit visual knowledge maps through conversation.
Documentation
Let your AI client work with the map.
Professional users can connect a compatible AI client to your KnowMapped account. It can use purpose-built tools to find, create, and refine maps.
Collaborate without flattening the map into a prompt.
MCP gives an AI client a structured interface to KnowMapped. The client works with concepts, relationships, metadata, and layouts as map objects rather than treating the graph as an unstructured block of text.
01
Find and retrieve
Search the maps available to your account and request full, compact, or summary representations.
02
Create and extend
Create maps, append findings, and use KnowMapped’s existing generation and credit controls.
03
Edit and arrange
Add, revise, connect, remove, and lay out map content with validation before changes are applied.
Use KnowMapped with ChatGPT or Codex.
ChatGPT
Add a custom app.
Turn on Developer mode under Settings → Security and login. In the composer, open ChatGPT Plugins, use the plus button to create a developer-mode app, select Streamable HTTP, and enter https://mcp.knowmapped.com/mcp. Complete the browser authorization, then refresh the app’s tools before starting a new chat.
Read OpenAI’s developer-mode guide
Codex
Add a remote MCP server.
Register the Streamable HTTP endpoint, then run the separate login command so Codex can complete the browser-based OAuth flow and cache the resulting credentials.
codex mcp add knowmapped --url https://mcp.knowmapped.com/mcp
codex mcp login knowmapped
codex mcp list
KnowMapped remains authoritative.
Every request is limited by the connected account’s existing map access. A public link does not grant edit permission, and a client cannot bypass ownership or sharing controls.
Each new map created through MCP uses 1 generation credit. Free and Professional users can use generation credits for MCP map creation. Reading or editing an existing map does not use credits. The creation preflight returns the current cost before a map is created, and failed validation does not consume credits.
Disconnect the integration from your client to remove its local connection. You can also revoke OAuth access from KnowMapped when you need to invalidate an existing authorization.
Discovery, authorization, and tools.
The server follows MCP Streamable HTTP and OAuth discovery conventions. Clients should begin with the MCP endpoint rather than configuring authorization endpoints manually.
Discovery
MCP endpoint
https://mcp.knowmapped.com/mcp
Protected resource
https://mcp.knowmapped.com/.well-known/oauth-protected-resource/mcp
Authorization server
https://app.knowmapped.com
OAuth
Grant
Authorization code with PKCE S256
Client registration
Client ID Metadata Documents, with Dynamic Client Registration fallback
Resource
https://mcp.knowmapped.com/mcp
| Scope | Purpose |
|---|---|
maps:read | Search and retrieve maps available to the connected account. |
maps:create | Run creation preflight and create maps. |
maps:write | Validate and apply edits to maps where the account has edit access. |
Current tools
search_knowmapped_maps
Search the connected account’s authorized map library.
get_knowmapped_map
Retrieve a full, compact, or summary map representation.
preflight_knowmapped_map_creation
Check eligibility and required credits before constructing a map.
create_knowmapped_map
Validate or create a map through KnowMapped’s shared creation service.
update_knowmapped_map
Validate or atomically apply revision-safe graph operations.
Start with the client’s tool refresh.
Tools do not appear
Refresh the integration’s tools and begin a new conversation. An existing conversation may retain the tool list it received when it started.
Sign-in does not open
Disconnect and reconnect KnowMapped in the client. Confirm that the client supports OAuth for remote MCP servers.
A map cannot be changed
Confirm that the connected KnowMapped account has Professional access and is an owner or editor of that map.