# GovLaws MPP Semantic Search

> GovLaws MPP Semantic Search is a paid API for AI agents from GovLaws at govlaws.ai, paid per call via MPP, $0.03/call, status down (last checked 2026-10-12).

Semantically searches U.S. federal regulations (CFR) and/or U.S. Code statutes using natural language queries, with pay-per-request access via the Machine Payment Protocol.

## Facts

- Endpoint: POST https://govlaws.ai/api/mpp/search?utm_source=zero.xyz
- Price: $0.03/call
- Payment: MPP
- Status: down
- Last checked: 2026-10-12
- Activations on Zero: 0
- Provider: GovLaws
- Docs: https://govlaws.ai/mpp
- Website: https://govlaws.ai
- Tags: legal, regulatory, government, citations, compliance, federal, data, search
- Canonical page: https://www.zero.xyz/c/govlaws-search-d3d763ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jPgZzDB4yKw6qwSCIWw6i

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability govlaws-search-d3d763ea -d '<json body>'
```

Example prompt: Search all federal regulations and statutes for 'fair credit reporting congressional findings' and return the top 5 most relevant results from both the CFR and U.S. Code.

## When to prefer this

Use this endpoint when you need semantic or keyword search over U.S. federal regulations (CFR) and/or U.S. Code statutes without holding a GovLaws API key, and you are willing to pay $0.03 USDC per request via the MPP 402 flow. Prefer this over the keyed /api/search endpoint when operating in keyless agent environments. Choose corpus='all' for broad legal research, 'regulations' for CFR-only, or 'statutes' for U.S. Code only.

## Known failure modes

- 402 Payment Required — MPP challenge issued before payment is submitted; agent must complete the 402 pay-and-replay flow
- Invalid corpus value — must be one of: regulations, statutes, all
- Query missing from request body — required field not provided
- Limit out of range — must be between 1 and 20
- No matching results — query returns empty ranked list for obscure or malformed queries
- Payment failure — USDC payment not accepted or insufficient funds

## How this service works

Semantic search across current U.S. federal regulations

## Output

A ranked list of up to 20 federal regulation or statute excerpts/citations matching the query, sourced from CFR and/or U.S. Code, with provenance metadata indicating the official government source.

## Example request

```json
{
 "limit": 5,
 "query": "artificial intelligence regulations"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "Maximum number of ranked results to return."
  },
  "query": {
   "type": "string",
   "example": "fair credit reporting congressional findings",
   "description": "Natural-language or keyword query over federal regulations and U.S. Code canary coverage."
  },
  "corpus": {
   "enum": [
    "regulations",
    "statutes",
    "all"
   ],
   "type": "string",
   "default": "regulations",
   "description": "Corpus filter. regulations = CFR only, statutes = U.S. Code only, all = CFR plus U.S. Code canary coverage. Defaults to regulations for backward compatibility."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "results",
  "query",
  "corpus",
  "total"
 ],
 "properties": {
  "query": {
   "type": "string"
  },
  "total": {
   "type": "integer"
  },
  "corpus": {
   "type": "string"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "citation",
     "title",
     "score",
     "snippet"
    ],
    "properties": {
     "score": {
      "type": "number"
     },
     "title": {
      "type": "string"
     },
     "snippet": {
      "type": "string"
     },
     "citation": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/govlaws-search-d3d763ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from govlaws.ai](https://www.zero.xyz/host/govlaws.ai/llms.txt)