@layers/amba-mcp

Amba is the agent-native backend-as-a-service for mobile and web apps. This package is the Model Context Protocol (MCP) tool registry that lets an AI agent drive the Amba admin API directly.

It exposes ~178 tools across ~17 groups (projects, push, segments, config, content, users, achievements, challenges, economy, leaderboards, platform, social, xp, events, auth, …) and is the same registry that powers the hosted MCP server at mcp.amba.dev.

Install

npm install @layers/[email protected]

Configure + first call

This package is a tool registry, not a transport. You mount it into your own MCP server:

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { registerAllTools, createApiClient } from '@layers/amba-mcp';

const server = new McpServer({ name: 'amba-mcp', version: '1.0.0' });

const apiClient = createApiClient({
  baseUrl: 'https://api.amba.dev/v1/admin',
  token: process.env.AMBA_DEVELOPER_TOKEN,
});

registerAllTools(server, apiClient);
// Then mount `server` behind any MCP transport (stdio, Streamable HTTP, SSE).

Bootstrap with no browser

Every tool except the public auth tools (amba_developer_signup, amba_developer_login, amba_developer_refresh) requires a developer Bearer token.

1. Call amba_developer_signup with no Authorization header — the response includes a long-lived Personal Access Token (pat) and a freshly provisioned project.
2. Pass the pat as the inbound Bearer on every subsequent MCP call.
3. Poll amba_get_provisioning_status until the project flips to status: "active" before issuing client traffic.

Omit token on createApiClient to fall back to the CLI credential file at ~/.amba/credentials.json.

Docs

Tool reference: https://docs.amba.dev/mcp.

License

Apache-2.0