Quickstart

Connect your first AI agent to Thoughtbox in under 5 minutes.

1

Create a workspace and get an API key

Sign up for a free account. After your workspace is created, navigate to API Keys in the sidebar and click Create key. Copy the key — it starts with tbx_ and is shown only once.

Create accountSign in
2

Add Thoughtbox to your MCP client config

Open your MCP client configuration file and add the Thoughtbox server:

{
  "mcpServers": {
    "thoughtbox": {
      "url": "https://api.thoughtbox.dev/mcp",
      "headers": {
        "Authorization": "Bearer tbx_YOUR_API_KEY"
      }
    }
  }
}

Replace tbx_YOUR_API_KEY with the key from step 1.

3

Create your first project

In your MCP client, ask your agent to call the create_project tool:

# Example prompt to your agent:
"Use thoughtbox to create a project called 'my-research'.
 Then capture this thought: 'Thoughtbox is connected and working.'"

The agent will call the Thoughtbox MCP tools and you should see the run appear in your Runs dashboard within seconds.

4

Verify in the dashboard

Open your workspace dashboard and check:

  • Projects page — your new project is listed
  • Runs page — the MCP session run is visible with a success status
  • The run detail shows the thoughts captured in sequence

Next steps