Ajiro API
Scans backend routes into per-endpoint YAML for API regression tests and mocks
- 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-apiAdd to claude_desktop_config.json
{
"mcpServers": {
"ajiro-api": {
"command": "npx",
"args": [
"-y",
"ajiro-api"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ajiro-api": {
"command": "npx",
"args": [
"-y",
"ajiro-api"
]
}
}
}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.
Alternatives to Ajiro API

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 467K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.8K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
- Remote
- Open source
- 34.6K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools