Which integrations are available for this server?

Allows creating and using AI-agent sessions powered by Google language models through the Thinker agent service, enabling message-based interactions with models via session management tools. Allows creating and using AI-agent sessions powered by OpenAI language models through the Thinker agent service, enabling message-based interactions with models like GPT via session management tools.

How do I use thinker-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@thinker-mcp Show me the current sprint board" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

thinker-mcp

Official

by thinker-ci

Overview Schema Related Servers Score Discussions

Python

Hybrid

thinker-mcp

MCP server for the thinker-ci platform. Exposes tickets, CI/CD pipelines, project-management data, and AI-agent sessions as MCP tools and resources so that Claude Code (or any other MCP-capable client) can interact with the platform directly from the assistant.

Architecture

Claude Code / Cursor / other MCP client
           │  stdio / SSE
           ▼
      thinker-mcp          ← this repo
     ┌──────────────────────────────────┐
     │  tools/tickets.py  (file-system) │─── reads/writes thinker-blueprint/
     │  tools/pipelines.py              │─── thinker-console REST API
     │  tools/pm.py                     │─── thinker-console REST API
     │  tools/agents.py                 │─── thinker-agent REST API
     │  resources/schema.py             │─── thinker-console /api/schema/
     │  resources/docs.py               │─── thinker-blueprint/ (local)
     └──────────────────────────────────┘
           │                      │
    thinker-console          thinker-agent
    (Django REST API)        (LLM agent API)
           │
    thinker-blueprint
    (git repo on disk)

thinker-console is the central Django application that owns projects, pipelines, runs, PM objects (epics, stories, tasks, sprints, milestones), and user/tenant data.

thinker-agent is a lightweight FastAPI service that manages stateful LLM sessions. It proxies requests to Anthropic, OpenAI, Google, and AWS Bedrock.

thinker-blueprint is a git repository of Markdown files that serves as the project's file-system ticketing system. The tickets/ tree is readable and writable by thinker-mcp without going through an API.

Related MCP server: linear-mcp-server

Installation

From source (development)

git clone git@github.com:thinker-ci/thinker-mcp.git
cd thinker-mcp
pip install -e .

Via uvx (no checkout required)

uvx thinker-mcp

Configuration

Copy .env.example to .env and fill in the values:

cp .env.example .env
$EDITOR .env

Variable	Default	Description
`THINKER_CONSOLE_URL`	`http://localhost:8000`	Base URL of the thinker-console Django API
`THINKER_CONSOLE_TOKEN`	(required)	API token for authenticating to thinker-console (`Token <value>`)
`THINKER_AGENT_URL`	`http://localhost:8080`	Base URL of the thinker-agent FastAPI service
`THINKER_AGENT_TOKEN`	(required)	Bearer token for authenticating to thinker-agent
`THINKER_BLUEPRINT_PATH`	`/data/thinker-blueprint`	Absolute path to a local checkout of thinker-blueprint

Tools

Ticket tools (file-system)

These tools read from and write to the tickets/ tree inside a local thinker-blueprint checkout. No network calls are made.

Tool	Parameters	Description
`tickets_list`	`status`, `type`, `sprint`, `assignee`	List tickets with optional filters
`ticket_get`	`id`	Get full markdown content of a ticket (e.g. `STORY-003`)
`ticket_update_status`	`id`, `status`	Update the `status:` frontmatter field
`ticket_create`	`type`, `title`, `description`, `epic_id`, `priority`, `sprint`	Create a new ticket file

Pipeline tools (thinker-console)

Tool	Parameters	Description
`pipelines_list`	`project_slug`	List pipelines for a project
`pipeline_trigger`	`pipeline_id`, `branch`, `commit_sha?`	Trigger a pipeline run
`run_get`	`run_id`	Get status and metadata for a run
`run_logs`	`job_id`	Fetch raw logs from a job
`run_cancel`	`run_id`	Cancel a running pipeline run
`runners_list`	—	List all CI runners and their status

Project-management tools (thinker-console)

Tool	Parameters	Description
`epics_list`	`status?`, `milestone?`	List epics
`stories_list`	`epic_id?`, `sprint_id?`, `status?`	List stories
`tasks_list`	`story_id?`, `assignee?`, `status?`	List tasks
`story_update`	`story_id`, `status?`, `story_points?`	Update a story
`task_create`	`title`, `story_id`, `task_type?`, `estimate?`	Create a task
`sprint_board`	—	Current sprint kanban board
`sprints_list`	—	List all sprints
`milestones_list`	—	List all milestones

Agent tools (thinker-agent)

Tool	Parameters	Description
`agent_session_create`	`provider`, `model_id`, `system_prompt?`	Create a new LLM session
`agent_message_send`	`session_id`, `message`	Send a message; returns the assistant response
`agent_sessions_list`	—	List all active sessions

Resources

URI	MIME type	Description
`thinker://openapi/schema`	`application/json`	Live OpenAPI 3.x schema from thinker-console
`thinker://docs/architecture`	`text/markdown`	Concatenated `architecture/*.md` from thinker-blueprint
`thinker://tickets/<stem>`	`text/markdown`	Individual ticket file (e.g. `thinker://tickets/STORY-003-tenant-model`)

Using with Claude Code

Add to your project's .claude.json (or ~/.claude.json for global access):

{
  "mcpServers": {
    "thinker": {
      "command": "thinker-mcp",
      "env": {
        "THINKER_CONSOLE_URL": "https://console.thinker.ci",
        "THINKER_CONSOLE_TOKEN": "your-token-here",
        "THINKER_AGENT_URL": "https://agent.thinker.ci",
        "THINKER_AGENT_TOKEN": "your-agent-token-here",
        "THINKER_BLUEPRINT_PATH": "/home/you/thinker-blueprint"
      }
    }
  }
}

Or use a .env file in your working directory instead of inline env keys.

Restart Claude Code after editing the config. Run /mcp to verify the server is connected and tools are listed.

Using with other MCP clients

Any client that supports the MCP stdio transport can connect by spawning:

thinker-mcp

The server reads STDIN and writes STDOUT using the JSON-RPC framing defined by the MCP protocol. Set the environment variables above before launching.

Running in Docker

docker build -t thinker-mcp .
docker run --rm -i \
  -e THINKER_CONSOLE_URL=http://console:8000 \
  -e THINKER_CONSOLE_TOKEN=secret \
  -e THINKER_AGENT_URL=http://agent:8080 \
  -e THINKER_AGENT_TOKEN=secret \
  -v /data/thinker-blueprint:/data/thinker-blueprint:ro \
  thinker-mcp

Development

# Install in editable mode with dev extras (add [dev] if you add them to pyproject.toml)
pip install -e .

# Lint
ruff check src/

# Format
ruff format src/

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

paperclip-mcp
Agent Orchestration Project Management
bruhsb
A
license
A
quality
C
maintenance
MCP server that exposes the Paperclip control plane API as tools for Claude Code agents — manage issues, coordinate agents, post comments, and orchestrate work without direct API calls.
Updated 3 months ago (2026-04-28 19:32 UTC)
100
53
2
MIT
linear-mcp-server
Project Management Developer Tools
dshurick
F
license
-
quality
D
maintenance
MCP server for integrating Linear with Claude Code and other MCP clients. Enables issue management, project planning, and status tracking through a set of tools.
Updated 6 months ago (2026-01-31 22:22 UTC)
Flow Boards MCP Server
Project Management Developer Tools
Germanicus1
F
license
B
quality
D
maintenance
MCP server that exposes the full Flow Boards REST API as Claude tools, enabling natural language management of tickets, flows, bins, boards, comments, and more.
Updated 5 months ago (2026-03-16 06:46 UTC)
38
11
1
ai-devtool-mcp-server
Developer Tools Version Control
surajrsawat
F
license
-
quality
B
maintenance
MCP server for AI DevTool workflow, exposing tools and resources for code review, repository chat, and repository operations.
Updated a month ago (2026-06-30 16:38 UTC)
1

View all related MCP servers

Related MCP Connectors

Backtest360
MCP server exposing the Backtest360 engine API as tools for AI agents.
microservices.sh
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
server
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/thinker-ci/thinker-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

thinker-mcp

Architecture

Installation

From source (development)

Via uvx (no checkout required)

Configuration

Tools

Ticket tools (file-system)

Pipeline tools (thinker-console)

Project-management tools (thinker-console)

Agent tools (thinker-agent)

Resources

Using with Claude Code

Using with other MCP clients

Running in Docker

Development

Maintenance

Resources

Looking for Admin?

Related MCP Servers

paperclip-mcp

linear-mcp-server

Flow Boards MCP Server

ai-devtool-mcp-server

Related MCP Connectors

Latest Blog Posts

MCP directory API