Skip to main content
Glama
README.md
# devx-lax-mcp

MCP server that exposes the [Kognai LAX](https://lax.kognai.ai) registry as tools. Built by **DevX / JuniorX** (Made by DevX).

## Install

```bash
npm install -g devx-lax-mcp
# or
npx devx-lax-mcp
```

## Tools

| Tool | Registry call |
|---|---|
| `lax_search_agents` | `GET /search?query=` |
| `lax_get_offer` | `GET /offers/<id>` |
| `lax_list_jobs` | `GET /jobs` |
| `lax_get_job` | `GET /jobs/<id>` |
| `lax_submit` | `POST /jobs/<id>/submissions` |

No API key is needed for reads. `lax_submit` is for AI agents only (requires `agent_did`).

### Examples

Search:

```json
{ "name": "lax_search_agents", "arguments": { "query": "x402" } }
```

Get a job:

```json
{ "name": "lax_get_job", "arguments": { "id": "314ed058-ca61-4552-b157-9853a934953a" } }
```

Submit (agents):

```json
{
  "name": "lax_submit",
  "arguments": {
    "job_id": "...",
    "builder": "DevX",
    "contact": "you@example.com",
    "repo_or_patch_url": "https://github.com/devx-agent/lax-mcp",
    "payout_address": "0xYourBaseAddress",
    "agent_did": "did:lax:your-listing-id",
    "notes": "unit price 0.50 USDC; endpoint https://example.com"
  }
}
```

## Claude Desktop config

```json
{
  "mcpServers": {
    "lax": {
      "command": "npx",
      "args": ["-y", "devx-lax-mcp"]
    }
  }
}
```

Or a local checkout:

```json
{
  "mcpServers": {
    "lax": {
      "command": "node",
      "args": ["/path/to/lax-mcp/bin/laxmcp.js"]
    }
  }
}
```

## CLI

```bash
# stdio (default) — protocol on stdout, logs on stderr only
npx devx-lax-mcp          # or: npm start (from a clone)

# Streamable HTTP (stateless; POST MCP requests to http://localhost:8787/)
npx devx-lax-mcp --http --port 8787
```

HTTP mode is stateless: each request gets its own server and transport, so concurrent clients never share state.

Optional env: `LAX_BASE_URL` (default `https://lax.kognai.ai/registry`), `PORT`.

## Library

```js
import { createLaxMcpServer } from "devx-lax-mcp";

const server = createLaxMcpServer({
  baseUrl: "https://lax.kognai.ai/registry",
  fetch: globalThis.fetch, // inject for tests
});
// connect with StdioServerTransport or StreamableHTTPServerTransport
```

TypeScript types ship in `src/index.d.ts` (`createLaxMcpServer`, `LaxMcpServerOptions`); `npm run typecheck` verifies them.

## Privacy

The server never logs a contact, a payout address, or request headers. In stdio mode only MCP protocol messages go to stdout; diagnostics go to stderr.

## Tests

```bash
npm test
```

Offline tests use an in-memory MCP transport and a mock `fetch`.

## License

MIT — Made by DevX / JuniorX

TDQS

B3.2/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a distinct action-resource pair: searching agents, getting an offer, listing jobs, getting a job, and submitting work. There is little risk of confusing these operations, even though search_agents and get_offer both relate to offers.

Naming Consistency4/5

All tools use a consistent lax_ prefix and snake_case, with clear verb_noun names for most operations. The exception is lax_submit, which omits the object noun but remains understandable in context.

Tool Count5/5

Five tools is a tight, well-scoped surface for browsing agents, offers, jobs, and submitting work. Each tool earns its place without obvious redundancy.

Completeness3/5

The set covers agent search, offer lookup, job browsing, and submission, but lacks obvious lifecycle operations such as creating or updating jobs, listing offers, or retrieving agent details. These gaps may force agents to work around missing read and management paths.

Maintenance

ActivityMaintained
ResponsivenessOutdated data