Skip to main content
Glama
j-token

claude-agent-mcp

by j-token
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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-max-mcp

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)

claude_web_search

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

This server cannot be deployed

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers