{
  "markdown": "# Rival Regulatory Toolkit\n\nOpen-source SDK, CLI, MCP server, and schemas for connecting AI agents to Rival's source-grounded regulatory retrieval API.\n\n- Public site: https://tryrival.ai\n- Agent access: https://tryrival.ai/for-agents\n- Managed API default: `https://api.tryrival.ai`\n\nThis repository is the developer and agent connectivity layer for Rival. It is intentionally read-only in its first release: agents can search, retrieve source text, trace citations, list authorities, and inspect recent filings. Workspace actions, document review, evidence requests, filings, and task creation remain behind managed Rival access and human review gates.\n\n## What Is Included\n\n- OpenAPI contract for Rival's read-only regulatory retrieval API.\n- JSON Schemas for source documents, search results, citations, authorities, and recent filings.\n- TypeScript client for server-side applications and internal tools.\n- CLI for shell usage and automation.\n- MCP server for agent clients that support Model Context Protocol.\n- Fixture mode so teams can evaluate the integration without a Rival API key.\n- Dockerfile for running the MCP server in controlled team environments.\n\n## Install\n\n```sh\nnpm install @rival-intelligence/regulatory-toolkit\n```\n\nFor local development from source:\n\n```sh\nnpm install\nnpm run build\n```\n\n## Environment\n\n```sh\nexport RIVAL_API_KEY=\"rv_live_...\"\nexport RIVAL_API_BASE_URL=\"https://api.tryrival.ai\"\n```\n\nFor local evaluation without API access:\n\n```sh\nexport RIVAL_FIXTURE_MODE=true\n```\n\n## TypeScript Client\n\n```ts\nimport { RivalRegulatoryClient } from '@rival-intelligence/regulatory-toolkit';\n\nconst rival = new RivalRegulatoryClient({\n  apiKey: process.env.RIVAL_API_KEY,\n});\n\nconst results = await rival.searchRegulatoryCorpus({\n  query: '49 CFR 195.573',\n  limit: 5,\n});\n\nconsole.log(results.results[0]?.source.citation);\n```\n\n## CLI\n\n```sh\nrival-regulatory search \"49 CFR 195.573\"\nrival-regulatory source \"cfr-49-195-573\"\nrival-regulatory trace \"49 CFR 195.573\"\nrival-regulatory authorities\n```\n\nFixture mode:\n\n```sh\nrival-regulatory search \"pipeline corrosion\" --fixture\n```\n\n## MCP Server\n\nRun directly:\n\n```sh\nnpx @rival-intelligence/regulatory-toolkit mcp\n```\n\nMCP client example:\n\n```json\n{\n  \"mcpServers\": {\n    \"rival-regulatory\": {\n      \"command\": \"npx\",\n  \"args\": [\"-y\", \"@rival-intelligence/regulatory-toolkit\", \"mcp\"],\n      \"env\": {\n        \"RIVAL_API_KEY\": \"rv_live_...\",\n        \"RIVAL_API_BASE_URL\": \"https://api.tryrival.ai\"\n      }\n    }\n  }\n}\n```\n\nAvailable MCP tools:\n\n- `search_regulatory_corpus`\n- `retrieve_source_text`\n- `trace_citation`\n- `list_authorities`\n- `get_recent_filings`\n\n## Docker\n\nDocker belongs in this repository because many compliance, legal, consulting, energy, and infrastructure teams will run agent tools inside controlled environments. The image runs the MCP server and reads credentials from environment variables.\n\n```sh\ndocker build -t rival-regulatory-toolkit .\ndocker run --rm -i \\\n  -e RIVAL_API_KEY=\"$RIVAL_API_KEY\" \\\n  -e RIVAL_API_BASE_URL=\"https://api.tryrival.ai\" \\\n  rival-regulatory-toolkit\n```\n\nFixture mode:\n\n```sh\ndocker run --rm -i -e RIVAL_FIXTURE_MODE=true rival-regulatory-toolkit\n```\n\nSee [docs/self-hosting.md](docs/self-hosting.md) for deployment notes.\n\n## API Contract\n\nThe API contract starts with five read-only endpoints:\n\n- `GET /api/v1/search`\n- `GET /api/v1/sources/{source_id}`\n- `GET /api/v1/citations/trace`\n- `GET /api/v1/authorities`\n- `GET /api/v1/filings/recent`\n\nThe contract lives in [openapi/rival-regulatory-api.yaml](openapi/rival-regulatory-api.yaml).\n\n## Safety Boundary\n\nThis toolkit does not submit filings, alter compliance records, close corrective actions, delete evidence, or take workspace actions. It is a source retrieval and citation layer for agents and developer systems. Regulated work still requires qualified human review.\n\nThis toolkit is not legal, engineering, environmental, safety, or compliance advice. Teams are responsible for validating applicability, obligations, filings, and operational decisions with qualified professionals.\n\n## Development\n\n```sh\nnpm install\nnpm run build\nnpm test\n```\n\n## License\n\nApache-2.0\n",
  "bytes": 4163,
  "sha": "f39aef1366d70d1d28d25dc7b110195b916548801de58f8169d20726fd8776ea",
  "repo_slug": "rival-intelligence/rival-regulatory-toolkit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rival_intelligence_rival_regul_e0008435/readme"
}