# Ajiro API

> Ajiro API is an open-source MCP server for developer tools. Scans backend routes into per-endpoint YAML for API regression tests and mocks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Website:** https://nititech.jp
- **Repository:** https://github.com/niti-lab/ajiro-api
- **MCP Registry name:** io.github.NITI-Lab/ajiro-api
- **Categories:** developer tools
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ajiro-api
