Skip to content
MCP server

Ajiro API

Scans backend routes into per-endpoint YAML for API regression tests and mocks

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.2.2
Listing updated
today

About Ajiro API

Ajiro API is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The README describes Ajiro API as a CLI that statically reads backend route definitions and writes one YAML file per endpoint. Those files can then be run as regression tests against a running app, or served as mock responses. It supports Next.js Route Handlers, Hono, FastAPI, Express and several Go routers.

The design centres on AI coding agents such as Claude Code and Codex. With the --json flag, a failing check reports the request, response body and handler location, so an agent can fix the code and re-run the tests itself. Secrets are referenced from .env rather than written into YAML, and usage telemetry is off by default.

The project is aimed at developers and small teams who want API tests kept in plain, Git-friendly files, and who can convert to and from OpenAPI, Postman or Bruno collections.

Install

Run in a terminal

claude mcp add ajiro-api -- npx -y ajiro-api

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ajiro-api": {
      "command": "npx",
      "args": [
        "-y",
        "ajiro-api"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ajiro-api": {
      "command": "npx",
      "args": [
        "-y",
        "ajiro-api"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ajiro-api": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ajiro-api"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ajiro-api": {
      "command": "npx",
      "args": [
        "-y",
        "ajiro-api"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ajiro-api": {
      "command": "npx",
      "args": [
        "-y",
        "ajiro-api"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

scan
Scans backend routes into YAML files.
test
Runs the API endpoint tests.
list
Lists defined endpoints.
validate
Validates YAML syntax, schema and references.
get_endpoint
Returns a single endpoint definition.
schema
Returns the JSON Schema.

What it does

Route scanning to YAML
Static analysis of supported frameworks writes one YAML file per endpoint, with source location.
Regression test runner
Runs endpoint tests and checks status, body schema and field matches, with a generated smoke test for endpoints without tests.
Mock server
Serves the mock responses defined in each YAML file, with scenario switching by header or query.
Agent-readable failure output
The --json output includes the failing check, expected and actual values, and source location, with secrets masked.
OpenAPI and collection import
Converts OpenAPI 3.x, Postman collections and Bruno folders to and from the YAML format.
CI drift detection
A scan --check mode exits non-zero when the YAML is out of date, and JUnit XML output is available.

Good for

  • Letting a coding agent implement an endpoint, then test and fix it in a loop
  • Running API regression tests in a CI pipeline
  • Serving mock responses for frontend work before the backend is ready
  • Generating a shareable HTML API reference for clients
  • Migrating an existing Postman or Bruno collection to plain YAML

Pricing

Open source

MIT licensed CLI, skill and test runner are free; a paid desktop GUI is planned.

Prices change. Check nititech.jp before you buy.

Ajiro API FAQ

Which frameworks are supported?

The README lists Next.js Route Handlers, Hono, FastAPI, Express, and Go net/http, chi and Echo. GraphQL, gRPC and WebSocket are out of scope.

Is it free?

The README states that the CLI, Claude Code skill, test runner, MCP server and importers are MIT licensed and free, and that they stay free in later phases. A paid desktop GUI is planned but has no date.

Does it send my API definitions anywhere?

The README says API definitions and test results are kept local, and telemetry is off unless the user turns it on. It records only command name, version and OS in that case.

How is it installed?

The README lists npx, Homebrew, cargo and GitHub Releases binaries.

Is Ajiro API free?

Yes. Ajiro API is open source, so you can use and self-host it for free.

How do I add Ajiro API to Claude Code?

Run this command in your terminal: claude mcp add ajiro-api -- npx -y ajiro-api

What are the best alternatives to Ajiro API?

The closest alternatives to Ajiro API are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers

Alternatives to Ajiro API

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 467K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.8K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    • Remote
    • Open source
    • 34.6K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools