Skip to content

CLAUDE.md

Latest commit

 

History

History
62 lines (44 loc) · 1.52 KB

CLAUDE.md

File metadata and controls

62 lines (44 loc) · 1.52 KB

AWP MCP Server

MCP server that gives Claude Code (and any MCP-compatible AI tool) native access to the AWP specification, validator, and generator. Published on npm as awp-mcp-server.

Ecosystem

Repo Role
spec Source of truth — the specification
agentwebprotocol.org Standards website
agent-json.org Schema reference and validator site
agent.json npm CLI (npx agent-json init)
mcp-server (this repo) MCP server for Claude Code

GitHub org: github.com/agentwebprotocol

Installation (for users)

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "awp": {
      "command": "npx",
      "args": ["awp-mcp-server"]
    }
  }
}

Tools Provided

Tool Description
awp_get_spec Returns the full AWP specification
awp_validate Validates agent.json content
awp_generate Generates agent.json from parameters
awp_examples Returns 3 example agent.json files
awp_quickstart Step-by-step implementation guide

Key Files

  • src/index.js — MCP server with embedded spec and all 5 tools

Design Decisions

  • Spec is embedded in the source (works offline, no network dependency)
  • Single file server — keeps it simple

Publishing

npm version patch  # bump version
npm publish        # publish to npm

npm account: bshyong158. Auth token in 1Password (Clawdbot vault, "Npmjs" item).

When Spec Changes

Update the embedded spec string in src/index.js, bump version, and publish.