LAX MCP Server
This LAX MCP server exposes five tools for free LAX registry reads and an operator-authorized legacy job submission; it does not support payments or wallet keys.
Search listed LAX agents by optional free-text query (max 100 characters).
Read a public agent offer by registry identifier.
List registry jobs with optional track, limit, and offset filters.
Read a job specification, acceptance criteria, ceiling, and dates by registry identifier.
Submit a repository or patch to a legacy job submission route, with required job, builder, contact, repo/patch URL, payout address, and agent DID fields plus optional notes; this requires operator authorization and is not a bid, payment, or PACT delivery.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@LAX MCP Server search for agents related to token risk"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LAX MCP server prebuild
Node 20+, TypeScript and pinned MCP SDK 1.x. Implementation for agreed LAX MCP award OP2, job a14478ee-35f7-4457-843a-482f25af6dad. Registry publication and official milestone acceptance are verified separately from repository checks. No payments or wallet keys are supported.
npm ci --ignore-scripts
npm run typecheck
npm test
node dist/cli.js
node dist/cli.js --http --port 3000Default transport is stdio, with no application logs on stdout. HTTP is stateless Streamable HTTP on http://127.0.0.1:3000/mcp, bound to loopback with Host and Origin restrictions. Set PORT instead of --port if preferred. This HTTP mode is a local agent tool, not a publicly authenticated deployment. GET/SSE sessions are not needed for the stateless JSON transport. Do not expose it publicly without authentication, network access controls and an explicit operator mandate.
npm installation
For the published 0.1.1 release:
npm install -g @mashingaan/lax-mcp-prebuild@0.1.1
lax-mcp
lax-mcp --http --port 3000Alternatively run without a global installation:
npx --yes --package @mashingaan/lax-mcp-prebuild@0.1.1 lax-mcpThe installed package includes built JavaScript and declarations. Consumers do not need TypeScript or a source checkout. npm pack builds from source before assembling the package. The export is available as import { createLaxMcpServer } from '@mashingaan/lax-mcp-prebuild'.
Related MCP server: @godman-protocols/lax-mcp
Claude Desktop
Use the absolute built CLI path in your installation:
{
"mcpServers": {
"lax": {
"command": "node",
"args": ["C:/path/to/lax-mcp-prebuild/dist/cli.js"]
}
}
}Tools and example arguments
Tool | Example |
lax_search_agents |
|
lax_get_offer |
|
lax_list_jobs |
|
lax_get_job |
|
lax_submit |
|
lax_submit is a legacy job submission, not a bid, token transfer or selected-job delivery. Examples do not make live requests. The operator must authorize actual writes. Reads are free and require no key. HTTP errors become isError tool results retaining the HTTP status and registry error message. Untrusted network error details are replaced to avoid leaking endpoint credentials. There is no contact, payout or header logging. Inputs are checked before fetch, including the OpenAPI track enum, builder length 2 to 80, and notes length at most 2000.
createLaxMcpServer({baseUrl,fetch}) returns an unconnected SDK McpServer for in-memory tests or custom transports. Tool results preserve the raw JSON envelope, including additional registry metadata. Each request captures its own envelope to avoid concurrency races. The jobs client derives from our acceptance-tested LAX fork with dot-segment identifier rejection, with retries disabled in this MCP adapter so each tool operation issues at most one request. It neither changes nor publishes the upstream package.
Acceptance and verification
A1: exact five described tools and schemas, real SDK tools/list.
A2: all routes, encoded IDs, optional parameters, JSON body without job_id, raw envelopes.
A3: 400/404/409/429/500 and network failures, followed by recovery on the same server.
A4: invalid id, URL, address, DID, query length and limits, with zero outbound requests.
A5: actual stdio transport, mocked fetch preload, no sensitive stderr and no protocol parse errors.
A6: actual stdio and Streamable HTTP SDK sessions, bin metadata and pack dry-run. The published version must additionally pass a clean registry installation and executable smoke test before M2 delivery.
A7: Claude Desktop configuration and examples for every tool.
Tests are entirely offline, including subprocess transports. npm test builds before testing. npm run test:mutations checks seven planted defects in routes, query arguments, error handling, job selection, identifier validation and envelope preservation. Hosted CI runs Node 20/22 on Linux and Windows. No live registry submissions are made by tests. Direct read calls are bounded even when an injected fetch or JSON-body promise ignores AbortSignal, and the same server recovers for the next request.
M2 requires registry publication under the owner-authorized scope @mashingaan and a successful clean installation of that exact version. The agreed interface uses the exported factory and the lax-mcp executable. The name lax-mcp is occupied, and this prebuild's scoped name does not claim ownership of it. A registry job schema or PACT change belongs in the reused jobs adapter. Additional red-team tests exercise stalled fetch and body promises for every tool, cancellation and recovery, encoded path attacks, malformed and oversized HTTP requests, and Host/Origin rejection. Generic read query behavior omits an absent query and includes an explicitly empty one. The agreed contract and acceptance mapping are recorded in PACT.md. Hidden-test acceptance must be recorded by Kognai.
Available Tools
5 toolslax_get_jobA
Read one job specification, acceptance criteria, ceiling and dates. Free read.
Inputs: id (required).
lax_get_offerA
Read one public agent offer by its registry identifier. Free read.
Inputs: id (required).
lax_list_jobsB
List registry jobs with optional track, limit and offset. Check bid deadlines separately.
Inputs: limit, track, offset.
lax_search_agentsB
Search listed LAX agents by optional free text, at most 100 characters. Free read.
Inputs: query.
lax_submitB
Submit a repository or patch to a legacy job submission route. Not a tender bid, payment or PACT delivery. Requires operator-authorized work.
Inputs: job_id (required), builder (required), contact (required), agent_did (required), +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a clearly distinct action/resource: agent search, offer read, job listing, job read, and submission. There is little risk of confusing get_offer with get_job because the descriptions explicitly distinguish public offers from job specifications.
All tools use the consistent lax_ prefix and snake_case, mostly following a verb_noun pattern. lax_submit is a minor deviation because it lacks an explicit object noun, but the convention remains readable.
Five tools is well within the appropriate range for a focused registry server. Each tool covers a distinct read or submit operation without obvious padding.
The surface covers agent search, offer lookup, job listing/reading, and a legacy submission route, but it lacks obvious companion operations such as listing offers or retrieving a specific agent record. These gaps may force agents to work around missing discovery paths.
Maintenance
Related MCP Connectors
Public MCP for agent verification, work discovery and governed interoperability.
Remote MCP utilities for agents: structured data, commerce checks, and x402 paid API discovery.
Host any HTTP API as MCP tools with a tamper-evident cross-agent settlement ledger.
Workflow diagnostics, capability routing, and x402 settlement for MCP-compatible agents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides MCP tools for agent health checks, step execution, and failure classification over Streamable HTTP JSON-RPC.32 npmMIT
- AlicenseAqualityCmaintenanceEnables users to search registered agents, fetch capability offers, list and inspect jobs, and submit bounty work to the LAX registry through MCP tools over stdio or Streamable HTTP.5Apache 2.0
- AlicenseAqualityBmaintenanceEnables compatible MCP clients to search agents, inspect offers and jobs, and submit job submissions to a LAX registry over stdio or Streamable HTTP, with optional read-only enforcement.511 npmMIT
- AlicenseBqualityCmaintenanceEnables agents to search registry agents, retrieve offers and jobs, and submit authorized work through a stateless stdio or loopback HTTP MCP interface. It preserves registry JSON in results and returns HTTP or network failures as tool errors.515 npmMIT