⚖️ Legal Peripherals MCP Server
A premium Model Context Protocol (MCP) server powered by FastMCP that exposes highly robust tools for automating legal operations and filing compliance. This server handles state-level Secretary of State (SOS) entities, off-hours compliant IRS Form SS-4 EIN drafting/scheduling, and corporate/LLC charter templates lookup.
Documentation — Installation, deployment, usage across the API and MCP official documentation.
🗺️ System Architecture
The following diagram illustrates how the Legal Peripherals MCP Server coordinates between external LLM clients, state Secretary of State (SOS) databases, the IRS Form SS-4 preparation engine, and local template resources:
graph TD
Client[LLM / Agent Client] <-->|stdio / Server-Sent Events| MCP[FastMCP Server]
subgraph Core Features [Legal Peripherals Engine]
MCP -->|SOSTOOL| SOS[Secretary of State Lookup]
MCP -->|EINTOOL| EIN[IRS Form SS-4 EIN Engine]
MCP -->|STATUTETOOL| STATUTE["Statute & Charter Templates"]
MCP -->|COMPLIANCETOOL| COMPLIANCE["Compliance + Domain Ontology Lookup"]
end
subgraph Ontology Suite [Compliance + Domain Modules]
COMPLIANCE -->|regulation_detail / gate_requirements| FRAMEWORKS["HIPAA · BSA/AML · OCC · Dodd-Frank<br/>CFPB · FLSA · Taxation · LLC"]
COMPLIANCE -->|list_domains / sector_lookup| DOMAINS["Regulatory · Employment · Commercial<br/>Privacy (GDPR/CCPA) · Corporate · Litigation"]
end
subgraph State Scraping Layer
SOS -->|Deep Scraper| TX[Texas Secretary of State]
SOS -->|Deep Scraper| DE[Delaware Division of Corporations]
SOS -->|Deep Scraper| WY[Wyoming Secretary of State]
SOS -->|Deep Scraper| NV[Nevada SilverFlume]
SOS -->|LLM Fallback| FB[Resilient Fallback Scraper]
end
subgraph IRS Filing Layer
EIN -->|Check EST Time| activeCheck{"Is Monday-Friday<br/>7:00 AM - 10:00 PM EST?"}
activeCheck -->|Yes / Override| fileNow[FILING IMMEDIATELY]
activeCheck -->|No| queueLater[QUEUED FOR SCHEDULING]
end
subgraph Statute Knowledge
STATUTE -->|State Statutes| defaults[Default Rules Mapping]
STATUTE -->|Documents| templates[Corporate/LLC Charter Templates]
end
🛠️ MCP Tools Mapping
The server registers the following standard FastMCP tools, which can be dynamically enabled or disabled via environment toggles:
Auto-generated — do not edit between the markers below.
Condensed action-routed tools (MCP_TOOL_MODE=condensed)
| MCP Tool | Toggle Env Var | Description |
|---|---|---|
draft_ein_form |
EINTOOL |
Draft IRS Form SS-4 and schedule EIN filing with off-hours compliance (Mon-Fri 7:00 AM - 10:00 PM EST). |
legal_compliance_lookup |
COMPLIANCETOOL |
Query the bundled compliance + domain ontology suite (KG-native, no external API). |
legal_ingest_filing_file |
INGESTTOOL |
Store a drafted filing file (e.g. drafts/*.txt) as a blob + :MediaAsset in the KG. |
legal_ingest_sos_entities |
INGESTTOOL |
Look up Secretary-of-State business entities and ingest them into the KG. |
lookup_statute_rules |
STATUTETOOL |
Query state statutory default rules and retrieve corporate/LLC charter templates. |
sos_entity_lookup |
SOSTOOL |
Perform Secretary of State entity lookup across 50 states (scrapers for TX, DE, WY, NV, resilient fallback for others). |
Verbose 1:1 API-mapped tools (MCP_TOOL_MODE=verbose or both)
2 per-operation tools — one per public API method (click to expand)
| MCP Tool | Toggle Env Var | Description |
|---|---|---|
legal_peripherals_close |
APITOOL |
Release transport resources and runtime-only TLS material. |
legal_peripherals_request |
APITOOL |
Invoke the request operation. |
6 action-routed tool(s) · 2 verbose 1:1 tool(s). Each is enabled unless its <DOMAIN>TOOL toggle is set false; MCP_TOOL_MODE selects the surface (intent default — the six verb-tools, granular set loaded on demand · condensed action-routed · verbose 1:1 · both). Auto-generated — do not edit.
MCP Configuration Examples
Install the connector-focused
[mcp]extra. Examples uselegal-peripherals-mcp[mcp]to add FastMCP / FastAPI throughagent-connector-sdk; the required Agent Connector SDK core still carriesepistemic-graph[full]. The[agent-runtime]extra additionally enables model orchestration.
stdio Transport (local IDEs — Cursor, Claude Desktop, VS Code)
{
"mcpServers": {
"legal-peripherals-mcp": {
"command": "uvx",
"args": [
"--from",
"legal-peripherals-mcp[mcp]",
"legal-peripherals-mcp"
],
"env": {
"MCP_TOOL_MODE": "intent",
"BYPASS_IRS_FILING_HOURS": "False",
"COMPLIANCETOOL": "True",
"EINTOOL": "True",
"EIN_TIMEOUT_SECONDS": "30",
"LEGAL_PERIPHERALS_BASE_URL": "http://localhost:8000",
"OPENCORPORATES_BASE_URL": "https://api.opencorporates.com/v0.4",
"SOSTOOL": "True",
"SOS_TIMEOUT_SECONDS": "30",
"STATUTETOOL": "True",
"STATUTE_TIMEOUT_SECONDS": "30"
}
}
}
}
Runtime references require an alias-aware launcher such as Arbora. Other launchers must omit those entries and inject the resolved values through their own runtime secret boundary.
Streamable-HTTP Transport (networked / production)
{
"mcpServers": {
"legal-peripherals-mcp": {
"command": "uvx",
"args": [
"--from",
"legal-peripherals-mcp[mcp]",
"legal-peripherals-mcp",
"--transport",
"streamable-http",
"--port",
"8000"
],
"env": {
"TRANSPORT": "streamable-http",
"HOST": "127.0.0.1",
"PORT": "8000",
"MCP_TOOL_MODE": "intent",
"BYPASS_IRS_FILING_HOURS": "False",
"COMPLIANCETOOL": "True",
"EINTOOL": "True",
"EIN_TIMEOUT_SECONDS": "30",
"LEGAL_PERIPHERALS_BASE_URL": "http://localhost:8000",
"OPENCORPORATES_BASE_URL": "https://api.opencorporates.com/v0.4",
"SOSTOOL": "True",
"SOS_TIMEOUT_SECONDS": "30",
"STATUTETOOL": "True",
"STATUTE_TIMEOUT_SECONDS": "30"
}
}
}
}
Alternatively, connect to a pre-deployed Streamable-HTTP instance by url:
{
"mcpServers": {
"legal-peripherals-mcp": {
"url": "http://localhost:8000/legal-peripherals-mcp/mcp"
}
}
}
Run a reviewed container image as a least-privilege stdio child (no listener or published port):
docker run -i --rm \
--read-only \
--cap-drop=ALL \
--security-opt=no-new-privileges \
--pids-limit=256 \
--tmpfs /tmp:rw,noexec,nosuid,nodev,size=64m \
-e TRANSPORT=stdio \
-e MCP_TOOL_MODE=intent \
-e BYPASS_IRS_FILING_HOURS=False \
-e COMPLIANCETOOL=True \
-e EINTOOL=True \
-e EIN_TIMEOUT_SECONDS=30 \
-e LEGAL_PERIPHERALS_BASE_URL=http://localhost:8000 \
-e OPENCORPORATES_BASE_URL=https://api.opencorporates.com/v0.4 \
-e SOSTOOL=True \
-e SOS_TIMEOUT_SECONDS=30 \
-e STATUTETOOL=True \
-e STATUTE_TIMEOUT_SECONDS=30 \
registry.example.invalid/legal-peripherals-mcp@sha256:<digest> legal-peripherals-mcp
For containerized network HTTP, supply an authenticated TLS ingress (or
direct server TLS), exact MCP_ALLOWED_HOSTS, and an exact trusted-proxy
CIDR policy through the operator-owned deployment profile. The generator
does not emit an unauthenticated non-loopback listener.
Auto-generated from the code-read env surface (MCP_TOOL_MODE + package vars) — do not edit.
Additional Deployment Options
legal-peripherals-mcp can run as a local stdio process or container, or behind a remote
network boundary. The
Deployment guide carries
the detailed transport contract.
- Local container — launch a reviewed immutable image as a least-privilege stdio child with no listener or published port.
- Remote URL — connect through an operator-supplied authenticated HTTPS
ingress. Keep its URL, outbound identity references, trust profile, and exact
MCP_ALLOWED_HOSTSinAgentConfig.
Deploy with agent-connector-sdk-deployment
Provision this package with the consolidated agent-connector-sdk-deployment
workflow. It selects an installed-package, editable-source, or immutable-container
path; records only runtime secret and TLS-profile references in AgentConfig; and
runs doctor, registration, policy, observability, and rollback gates. Ask your agent
to "deploy legal-peripherals-mcp with agent-connector-sdk-deployment".
| Install mode | Command |
|---|---|
| Installed package | uv tool install "legal-peripherals-mcp[mcp]", then run legal-peripherals-mcp |
| Immutable container | deploy registry.example.invalid/legal-peripherals-mcp@sha256:<digest> through the operator-selected orchestrator |
The repository embeds no deployment profile, credential value, certificate path, or
environment-specific endpoint. Supply those at runtime through AgentConfig and the
configured secret provider.
Environment Variables
Package environment variables
| Variable | Example | Description |
|---|---|---|
SOSTOOL |
True |
Tool Suite Toggles |
EINTOOL |
True |
|
STATUTETOOL |
True |
|
COMPLIANCETOOL |
True |
|
BYPASS_IRS_FILING_HOURS |
False |
IRS EIN API hours simulation override (optional, True to bypass hours restriction in dev) |
EIN_TIMEOUT_SECONDS |
30 |
EIN draft request timeout in seconds |
SOS_TIMEOUT_SECONDS |
30 |
Secretary of State entity lookup (OpenCorporates company registry) |
OPENCORPORATES_API_TOKEN |
secret-injected | |
OPENCORPORATES_BASE_URL |
https://api.opencorporates.com/v0.4 |
|
STATUTE_TIMEOUT_SECONDS |
30 |
Statute / charter lookup request timeout in seconds |
LEGAL_PERIPHERALS_BASE_URL |
http://localhost:8000 |
API Client Connection Configuration |
LEGAL_PERIPHERALS_TOKEN |
secret-injected | |
TLS_PROFILE |
private-ca |
AgentConfig named transport profile |
TLS_PROFILE_REF |
secret://transport/provider |
Direct runtime profile reference |
TLS_PROFILES_REF |
secret://transport/catalog |
Named runtime profile catalog |
Inherited agent-connector-sdk variables (apply to every connector)
| Variable | Example | Description |
|---|---|---|
TRANSPORT |
stdio |
MCP transport: stdio | streamable-http | sse |
HOST |
127.0.0.1 |
Loopback bind host (set an authenticated ingress explicitly) |
PORT |
8000 |
Bind port (HTTP transports) |
MCP_TOOL_MODE |
intent |
Tool surface: intent | condensed | verbose | both |
MCP_ENABLED_TOOLS |
— | Comma-separated tool allow-list |
MCP_DISABLED_TOOLS |
— | Comma-separated tool deny-list |
MCP_ENABLED_TAGS |
— | Comma-separated tag allow-list |
MCP_DISABLED_TAGS |
— | Comma-separated tag deny-list |
EUNOMIA_TYPE |
none |
Authorization mode: none | embedded | remote |
EUNOMIA_POLICY_FILE |
mcp_policies.json |
Embedded Eunomia policy file |
EUNOMIA_REMOTE_URL |
— | Remote Eunomia authorization server URL |
ENABLE_OTEL |
False |
Enable OpenTelemetry export |
OTEL_EXPORTER_OTLP_ENDPOINT |
— | OTLP collector endpoint |
MCP_CLIENT_AUTH |
— | Outbound MCP child auth: oidc-client-credentials | basic | none |
OIDC_CLIENT_ID |
— | OIDC client id (service-account auth) |
OIDC_CLIENT_SECRET_REF |
secret://identity/oidc-client-secret |
Runtime secret reference for the OIDC service account |
MCP_BASIC_AUTH_USERNAME |
— | HTTP Basic username (MCP_CLIENT_AUTH=basic) |
MCP_BASIC_AUTH_PASSWORD_REF |
secret://identity/mcp-basic-password |
Runtime secret reference for HTTP Basic auth (MCP_CLIENT_AUTH=basic) |
DEBUG |
False |
Verbose logging |
PYTHONUNBUFFERED |
1 |
Unbuffered stdout (recommended in containers) |
MCP_URL |
http://localhost:8000/mcp |
URL of the MCP server the agent connects to |
PROVIDER |
openai |
LLM provider for the agent |
MODEL_ID |
gpt-4o |
Model id for the agent |
15 package + 24 inherited variable(s). Auto-generated from .env.example + the shared agent-connector-sdk set — do not edit.
Governed capability contract
This package ships a compact canonical skill surface with specialist procedures
kept as referenced workflows. The current MCP tools, skill metadata,
connector_manifest.yml, ontology, mappings, shapes, fixtures, migrations,
tool-schema fingerprints, and certification metadata form one versioned
capability contract. Validate them together; do not rely on stale tool names or
historical per-task skill wrappers.
Runtime endpoints, credentials, certificate trust, tenant identity, retention, and observability policy are deployment inputs and are never packaged values. See Configuration, trust, and privacy before enabling a network transport, connector ingestion, Arbora delegation, or trace export.
Metadata
Release files for legal-peripherals-mcp 2.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| legal_peripherals_mcp-2.3.1.tar.gz | 128.5 kB | Without provenance | Details for legal_peripherals_mcp-2.3.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| legal_peripherals_mcp-2.3.1-py3-none-any.whl | Python 3 | none | any | Details for legal_peripherals_mcp-2.3.1-py3-none-any.whl |
Total release size: 293.4 kB
Release files / legal_peripherals_mcp-2.3.1.tar.gz
| Download URL | legal_peripherals_mcp-2.3.1.tar.gz |
|---|---|
| Size | 128.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2329190ac9c98613710579e3a1730a95a6f5b09ddc0859d2e5ca7affd7738998
|
|
BLAKE2b-256 checksum How to use checksums |
5a046a1c84218bcd35b1bdaf4a7b876b12490ccf621335a35f50be0a8b0cdaf3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / legal_peripherals_mcp-2.3.1-py3-none-any.whl
| Download URL | legal_peripherals_mcp-2.3.1-py3-none-any.whl |
|---|---|
| Size | 165.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d202ae6d96db52d1803c3ddb41d0d4f2253372bf88a490231f4b240d2410b399
|
|
BLAKE2b-256 checksum How to use checksums |
986367ca075d7a03bb01a39484b6c528a80581fa7f8ba99f9012ed15ca1dd2ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Security for legal-peripherals-mcp 2.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.