🔌

Chatwith MCP server

The Chatwith MCP server lets a compatible AI client inspect agents and knowledge sources, propose settings changes, and add a URL or attached file as knowledge.

Connect an MCP client

  1. Open Developer → API and copy your API key.
  1. In Claude, Cursor, or another MCP client, add a custom remote server using Streamable HTTP.
  1. Set the URL to https://api.chatwith.tools/mcp.
  1. Add Authorization: Bearer YOUR_API_KEY as an HTTP header.
  1. Connect, then ask the client to list your Chatwith Agents.
{
  "mcpServers": {
    "chatwith": {
      "url": "https://api.chatwith.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

What the server can do

  • List agents available to your account and read editable public settings.
  • List an agent’s knowledge sources.
  • Propose and apply supported agent settings changes.
  • Propose and add a public URL or attached file as a knowledge source.

Confirmation and permissions

Read operations run immediately. A settings change or new source is proposed first, then applied only after a separate explicit confirmation. Owners and editors can make changes; viewers cannot. Confirmation tokens are short-lived and cannot be reused.
💡
MCP client screens differ. Use the URL, Streamable HTTP transport, and Bearer header above even if your client does not use this exact JSON shape.

Troubleshooting

  • Authentication error: re-copy or regenerate the API key and verify the Bearer header.
  • Agent not found: confirm that the API-key owner has access.
  • Cannot edit: confirm that your role is owner or editor.
  • Expired confirmation: ask the client to propose the change again, review it, and confirm the new proposal.

Related guides