Skip to main content
Glama

claude-agent-mcp

An MCP (Model Context Protocol) server that wraps the Claude Agent SDK. It uses Claude Code's built-in OAuth authentication, so no API key is required — just claude login and you're ready to go.

Features

Tool

Description

claude_query

General-purpose queries — uses Claude's reasoning without any tools

claude_code_task

Coding tasks with file system access (read/write/edit/search)

claude_web_search

Web search with result summarization

claude_multi_turn

Fully customizable agent execution — configure tools, permissions, budget, and more

Related MCP server: claude-octopus

Prerequisites

Installation

git clone https://github.com/j-token/claude-agent-mcp.git
cd claude-agent-mcp
bun install

Usage

Run directly

bun start

Add to Claude Code as an MCP server

Add the following to your Claude Code MCP settings (~/.claude/settings.json):

{
  "mcpServers": {
    "claude-agent": {
      "command": "bun",
      "args": ["run", "/path/to/claude-agent-mcp/src/index.ts"]
    }
  }
}

Add to Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "claude-agent": {
      "command": "bun",
      "args": ["run", "/path/to/claude-agent-mcp/src/index.ts"]
    }
  }
}

Tools

claude_query

Send a prompt to Claude without any tools. Best for reasoning, text generation, and Q&A.

Parameter

Type

Required

Description

prompt

string

Yes

The prompt to send

systemPrompt

string

No

System prompt

model

string

No

Model to use (e.g., claude-sonnet-4-6)

maxTurns

number

No

Max conversation turns (default: 3)

claude_code_task

Perform coding tasks with file system access. Can read, write, edit, and search files.

Parameter

Type

Required

Description

prompt

string

Yes

Description of the coding task

cwd

string

No

Working directory (absolute path)

permissionMode

string

No

plan (default), acceptEdits, or bypassPermissions

allowedTools

string[]

No

Tools to allow (default: Read, Edit, Write, Glob, Grep, Bash)

model

string

No

Model to use

maxTurns

number

No

Max turns (default: 10)

Search the web and get a summarized result.

Parameter

Type

Required

Description

searchQuery

string

Yes

What to search for

model

string

No

Model to use

maxTurns

number

No

Max turns (default: 5)

claude_multi_turn

Fully customizable agent execution. Configure every aspect of the agent run.

Parameter

Type

Required

Description

prompt

string

Yes

The prompt

systemPrompt

string

No

System prompt

allowedTools

string[]

No

Tools to allow

permissionMode

string

No

default, acceptEdits, plan, or bypassPermissions

cwd

string

No

Working directory

model

string

No

Model to use

maxTurns

number

No

Max conversation turns

maxBudgetUsd

number

No

Max budget in USD

How It Works

┌─────────────┐     stdio      ┌───────────────────┐     OAuth     ┌─────────────┐
│  MCP Client │ ◄────────────► │ claude-agent-mcp  │ ◄───────────► │  Claude API  │
│ (Claude Code │                │  (this server)    │               │             │
│  / Desktop)  │                └───────────────────┘               └─────────────┘
└─────────────┘
  1. An MCP client (Claude Code, Claude Desktop, etc.) connects to this server via stdio.

  2. The client calls one of the registered tools (claude_query, claude_code_task, etc.).

  3. This server delegates the request to the Claude Agent SDK, which uses your existing OAuth session.

  4. The response is streamed back and returned to the client.

Development

# Type-check
bun run typecheck

# Build
bun run build

License

MIT

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

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/j-token/claude-agent-mcp'

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