Skip to main content
Glama

Scratchpad MCP Server

MCP Scratchpad Server

An MCP (Model Context Protocol) server that provides a "think" tool for structured reasoning, based on the Anthropic blog post.

Overview

The Scratchpad MCP server allows Claude and other LLMs to add dedicated thinking steps during complex tool use scenarios. This improves problem-solving by creating space for structured reasoning and helps the model carefully process tool call outputs.

Features

  • Think Tool: Add thoughts to a timestamped log for structured reasoning
  • Thoughts Log Resource: View all logged thoughts in JSON format
  • Clear Tool: Reset the thinking log when needed
  • Structured Thinking Prompt: Template for systematic problem-solving

Installation

Prerequisites

  • Python 3.11 or higher
  • uv package manager (recommended)

Setup

  1. Clone or download this repository
  2. Install dependencies:
    uv add "mcp[cli]"

Usage

Testing with MCP Inspector

Run the server in development mode:

uv run mcp dev scratchpad_server.py

This opens the MCP Inspector where you can:

  • Test the think tool
  • View the thoughts log resource
  • Clear the log
  • Try the structured thinking prompt

Installing in Claude Desktop

Install the server for use with Claude:

uv run mcp install scratchpad_server.py --name "Scratchpad"

Tools

think

Add a thinking step to the log.

Parameters:

  • thought (string): The thought to log

Example:

{ "thought": "I need to break this problem into smaller parts..." }

clear_thoughts

Clear all thoughts from the log.

No parameters required

Resources

log://thoughts

Returns all logged thoughts as a JSON array with timestamps.

Example output:

[ { "timestamp": "2024-01-20T10:30:45.123456", "thought": "First, I need to understand the requirements..." }, { "timestamp": "2024-01-20T10:31:02.789012", "thought": "The main components are X, Y, and Z..." } ]

Prompts

Structured Thinking

A template for systematic problem-solving using the think tool.

Parameters:

  • topic (string): The topic or problem to think through

Use Cases

The scratchpad tool is particularly useful for:

  1. Long chains of tool calls: Keep track of intermediate results and reasoning
  2. Complex problem-solving: Break down problems systematically
  3. Policy-heavy environments: Verify compliance with guidelines
  4. Sequential decision making: Document the reasoning process
  5. Edge case handling: Think through unusual scenarios

Example Workflow

  1. Start with a complex problem
  2. Use the "Structured Thinking" prompt to set up the approach
  3. Use the think tool multiple times to log reasoning steps
  4. Check progress with the log://thoughts resource
  5. Clear the log when starting a new problem

Best Practices

  • Use descriptive thoughts that explain the "why" not just the "what"
  • Break complex problems into smaller, manageable parts
  • Validate reasoning at each step
  • Summarize conclusions at the end
  • Clear the log between unrelated tasks

Development

To modify the server:

  1. Edit scratchpad_server.py
  2. Test changes with uv run mcp dev scratchpad_server.py
  3. Reinstall in Claude Desktop if needed

Future Enhancements

Potential improvements:

  • Persist thoughts to a file
  • Add search/filter capabilities
  • Support for thought categories or tags
  • Export thoughts in different formats
  • Integration with other reasoning tools
-
security - not tested
F
license - not found
-
quality - not tested

Provides a 'think' tool that allows Claude and other LLMs to add dedicated thinking steps during complex tool use scenarios, creating space for structured reasoning and improving problem-solving capabilities.

  1. Overview
    1. Features
      1. Installation
        1. Prerequisites
        2. Setup
      2. Usage
        1. Testing with MCP Inspector
        2. Installing in Claude Desktop
      3. Tools
        1. think
        2. clear_thoughts
      4. Resources
        1. log://thoughts
      5. Prompts
        1. Structured Thinking
      6. Use Cases
        1. Example Workflow
          1. Best Practices
            1. Development
              1. Future Enhancements

                Related MCP Servers

                • -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server that implements the 'think' tool, providing Claude with a dedicated space for structured thinking during complex problem-solving tasks to improve reasoning capabilities.
                  Last updated -
                  48
                  Python
                  MIT License
                  • Linux
                  • Apple
                • A
                  security
                  F
                  license
                  A
                  quality
                  Official implementation of Anthropic's 'think' tool that provides Claude with a dedicated space for structured reasoning, improving performance by up to 54% on complex tasks requiring multi-step problem solving.
                  Last updated -
                  1
                  525
                  37
                  TypeScript
                  • Apple
                • A
                  security
                  A
                  license
                  A
                  quality
                  Implements Anthropic's 'think' tool for Claude, providing a dedicated space for structured reasoning during complex problem-solving tasks that improves performance in reasoning chains and policy adherence.
                  Last updated -
                  4
                  105
                  5
                  JavaScript
                  MIT License
                • -
                  security
                  A
                  license
                  -
                  quality
                  Enables Claude's explicit thinking mode in Cursor, allowing users to see Claude's step-by-step reasoning process when prefacing queries with 'think'.
                  Last updated -
                  1
                  JavaScript
                  MIT License
                  • Linux
                  • Apple

                View all related MCP servers

                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/JoshuaOliphant/scratchpad_mcp'

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