# Micro — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and discover all available services in the micro.mu tools catalogue, or dive deep into any specific tool to learn its exact input parameters and capabilities. Get instant access to comprehensive details about what each service does and how to use it.

**Category:** Developer Tools | **Website:** [micro.mu/tools](https://micro.mu/tools) | **Docs:** [parse.bot/marketplace/65e85c13-58a6-41c6-83a1-30146c5c9c2d/micro-mu-api](https://parse.bot/marketplace/65e85c13-58a6-41c6-83a1-30146c5c9c2d/micro-mu-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/micro/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get mcp server info

Get the MCP server configuration metadata for micro.mu. Returns the server name, version, protocol version, supported capabilities, total tool count, transport type, and authentication method. Use this to obtain the details needed to register micro.mu as an MCP server in any compatible client.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/micro/get-mcp-server-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get tool

Get detailed information about a specific tool including its name, description, service, and full list of input arguments with types and descriptions. The tool name is the snake_case identifier shown on the tools page (e.g. 'apps_read', 'weather_forecast', 'news_search').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Tool name in snake_case format (e.g. 'apps_read', 'weather_forecast', 'news_search'). Available names are returned by list_tools in methods[*].name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/micro/get-tool \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'
```

### List tools

List all available tools from the micro.mu catalogue, grouped by service. Each service contains its methods with descriptions, API paths, auth requirements, and cost info. Optionally filter by service name to see only one service's tools. Returns all 33 services and ~120 methods when unfiltered.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `service` | string | No | Filter by service name (e.g. 'weather', 'news', 'flights'). When omitted, all services are returned. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/micro/list-tools \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"service":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.