Spec Oxide Mcp For Spec Driven Development With Claude Code To Avoid Token Waste

@marconae

2 days ago

Spec Oxide is a comprehensive workflow and toolset that enables spec-driven development for AI-assisted coding with Claude Code. You agree on what to build before any code is written. Spec Oxide ships a CLI and an MCP server to list and manage specifications as Markdown files as well as change proposals. A built-in search functionality finds the relevant spec files to avoid loading too many files into the Claude Code context window.

Overview Tools Comments

Overview

Spec Oxide

Spec-driven development for humans and AI - optimized for Claude Code with built-in MCP

Spec Oxide is a comprehensive workflow and toolset that enables spec-driven development for AI-assisted coding. You agree on what to build before any code is written.

What do you get?

📋 Spec Driven Workflow with three simple commands

Core principle: Specs are the source of truth. Changes are proposals that modify that truth.

/spox:propose - Propose a change and lock your intent
/spox:implement - Implement the defined task list with comprehensive verification
/spox:archive - Keep the accepted specs in sync by merging the change proposal The built-in Spox MCP server provides tools for spec and change management. Always use for spec operations—never use CLI commands or direct file manipulation when working through an AI agent.

Get started in minutes—no extra API keys required

For setup and update instructions read the Setup Guide. Setup takes just a couple of minutes. Besides Claude Code, there are no additional API keys required.

# Setup
cargo install spec-oxide

# Initialize a new project
spox init

# Run the setup script to configure MCP servers (Serena, Context7)
.spox/setup.sh

# Run Claude Code
claude

# Get started with /spox:setup

User Guide

Spec Oxide User Guide

Workflow with the built-in MCP server

Explore → list_specs, list_changes, search_specs
Understand → get_spec_requirements, get_scenario, get_change
Validate → validate_spec, validate_change

Example Usage

# List all specs
mcp__spox__list_specs

# Search for authentication-related specs
mcp__spox__search_specs query="authentication"

# Get requirements for a specific spec
mcp__spox__get_spec_requirements spec_id="auth"

# Validate a change proposal
mcp__spox__validate_change change_id="add-two-factor-auth"

Tool Reference

Tool	Description
`list_specs`	List all capability specs in the project
`get_spec_requirements`	Retrieve requirements from a specific spec
`get_scenario`	Get details of a specific scenario
`list_changes`	List all active change proposals
`get_change`	Retrieve full details of a change proposal
`search_specs`	Full-text search across all specs and changes
`validate_spec`	Validate a spec file for correctness
`validate_change`	Validate a change proposal before approval

Try in Playground

Server Config

{
  "mcpServers": {
    "spox": {
      "command": "spox",
      "args": [
        "mcp",
        "serve"
      ]
    }
  }
}

Build with ShipAny.