Serveur MCP Esheria Regulatory Intelligence
✓ VérifiéFournit une intelligence réglementaire étayée par des citations et des données de conformité multi-juridictionnelles via des packs publiés explicites.
Aussi connu sous esherialabs/esheria-python, esheria-python, esheria
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- 100
- Dernière version
- 1.2.2
- Dernier commit
- 15 juil. 2026
- Licence
- Apache-2.0
Qu'est-ce que Esheria Regulatory Intelligence MCP ?
Esheria Regulatory Intelligence est un serveur MCP. Fournit une intelligence réglementaire étayée par des citations et des données de conformité multi-juridictionnelles via des packs publiés explicites.
Résumé généré à partir du README du projet
À propos du MCP server Esheria Regulatory Intelligence
Les professionnels de la conformité et les développeurs peuvent accéder à une intelligence réglementaire étayée par des citations grâce à ce service pour gérer des données multi-juridictionnelles. En se connectant à l'endpoint hébergé ou en exécutant un serveur stdio local, les utilisateurs peuvent interagir avec des packs publiés explicites pour évaluer leur état de préparation actuel et suivre les évolutions réglementaires. Le système nécessite une clé API Esheria ou des identifiants OAuth pour fonctionner, lesquels peuvent être fournis via des variables d'environnement ou des bearer tokens.
L'ensemble d'outils offre un accès à un catalogue d'informations réglementaires, incluant les obligations, les sanctions et les calendriers de dépôt. Selon les permissions du token, les utilisateurs peuvent accéder à un entre 20 et 37 outils différents. Alors que les tokens standards permettent la lecture de données telles que les versions de packs et les événements de changement, les tokens opérateurs avec des scopes spécifiques comme monitoring:write permettent des workflows de modification d'état. Cette intelligence est conçue pour préserver les citations, les versions et les trace IDs à travers les workflows CLI, Python et MCP afin de garantir la traçabilité des données.
Ce que vous pouvez faire avec
- 1Surveiller les changements réglementairesLes développeurs peuvent utiliser le serveur pour identifier les différences entre les versions ou suivre les récents événements de changement au sein d'un pack spécifique.
- 2Auditer les obligations de conformitéLes utilisateurs peuvent récupérer des listes d'obligations légales et les sanctions associées pour évaluer la conformité réglementaire.
- 3Vérifier les affirmations réglementairesLe système permet la vérification des affirmations et la récupération du contexte des citations pour appuyer l'intelligence réglementaire.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Esheria Regulatory Intelligence MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Esheria Regulatory Intelligence MCP dans Claude Code
$ claude mcp add --env 'ESHERIA_API_KEY=<YOUR_ESHERIA_API_KEY>' esheria-python -- uvx esheriaInstaller Esheria Regulatory Intelligence MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"esheria-python": {
"command": "uvx",
"args": [
"esheria"
],
"env": {
"ESHERIA_API_KEY": "<YOUR_ESHERIA_API_KEY>"
}
}
}
}Installer Esheria Regulatory Intelligence MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"esheria-python": {
"type": "stdio",
"command": "uvx",
"args": [
"esheria"
],
"env": {
"ESHERIA_API_KEY": "<YOUR_ESHERIA_API_KEY>"
}
}
}
}Installer Esheria Regulatory Intelligence MCP dans VS Code CLI
$ code --add-mcp '{"name":"esheria-python","type":"stdio","command":"uvx","args":["esheria"],"env":{"ESHERIA_API_KEY":"<YOUR_ESHERIA_API_KEY>"}}'Installer Esheria Regulatory Intelligence MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"esheria-python": {
"command": "uvx",
"args": [
"esheria"
],
"env": {
"ESHERIA_API_KEY": "<YOUR_ESHERIA_API_KEY>"
}
}
}
}Installer Esheria Regulatory Intelligence MCP dans Codex
$ codex mcp add esheria-python --env 'ESHERIA_API_KEY=<YOUR_ESHERIA_API_KEY>' -- uvx esheriaInstaller Esheria Regulatory Intelligence MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.esheria-python] command = "uvx" args = ["esheria"] [mcp_servers.esheria-python.env] ESHERIA_API_KEY = "<YOUR_ESHERIA_API_KEY>"
Installer Esheria Regulatory Intelligence MCP dans Gemini CLI
$ gemini mcp add -s user -e 'ESHERIA_API_KEY=<YOUR_ESHERIA_API_KEY>' esheria-python uvx -- esheriaInstaller Esheria Regulatory Intelligence MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"esheria-python": {
"command": "uvx",
"args": [
"esheria"
],
"env": {
"ESHERIA_API_KEY": "<YOUR_ESHERIA_API_KEY>"
}
}
}
}Configuration
ESHERIA_API_KEYRequisSecretDashboard-created Esheria data token
ESHERIA_API_BASE_URLEsheria API base URL
ESHERIA_PACK_ID
| Nom | Description | Type |
|---|---|---|
| ESHERIA_API_KEY | Dashboard-created Esheria data token | RequisSecret |
| ESHERIA_API_BASE_URL | Esheria API base URL | |
| ESHERIA_PACK_ID | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleesherialabs/esheria-python is public and reachablegithub.com/esherialabs/esheria-python ↗Réussi
- Le nom du package correspond au dépôt sourceesheria names esherialabs/esheria-python as sourcepypi.org/project/esheria/ ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for esheriapypi.org/project/esheria/ ↗Réussi
- Licence open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-07-15github.com/esherialabs/esheria-python ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from esheriaRéussi
- Aucun avis critique dans le package ou ses dépendances32 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPHTTPS endpoint answered 401 (sign-in required)Réussi
README
Voir sur GitHubEsheria CLI And MCP
Installable command-line and MCP tools for the Esheria Regulatory Pack API.
Global, citation-backed regulatory intelligence for explicit published packs. Discover current readiness, select the intended jurisdiction and pack, and preserve citations, versions, limitations, and trace IDs across CLI, Python, and MCP workflows. Esheria provides regulatory intelligence, not legal advice.
The package exposes two commands:
esheria --help
esheria-mcp --help
esheria mcp serve --help
Version 1.2.2 is the production/stable public release. The CLI, Python
client, and MCP software distributed in the esheria Python package are
licensed under the Apache License 2.0. Hosted API/MCP access, regulatory data,
service outputs, and Esheria trademarks are not licensed under Apache-2.0;
they remain governed by the Esheria Terms of Service,
Privacy Policy, and any applicable customer
agreement. See LICENSE and NOTICE for the exact boundary.
CLI Quickstart
- Create a data API token in the Esheria dashboard.
- Install the command.
pipxis recommended because it keeps command-line tools isolated from project dependencies:
pipx install esheria
If you do not use pipx, use normal pip:
python3 -m pip install esheria
- Configure your shell. Put these in your terminal for a one-off test, or in
~/.zshrc,~/.bashrc, or your shell profile to keep them:
export ESHERIA_API_BASE_URL="https://api.esheria.ai"
export ESHERIA_API_KEY="<client-api-key>"
PowerShell:
$env:ESHERIA_API_BASE_URL = "https://api.esheria.ai"
$env:ESHERIA_API_KEY = "<client-api-key>"
ESHERIA_API_TOKEN is also accepted as an alias when ESHERIA_API_KEY is
unset.
Do not commit API keys. The CLI and MCP server read credentials from
environment variables or command-line flags and redact API key values from
diagnostic output. Prefer the environment variable: --api-key can be exposed
through shell history or the operating-system process list.
- Confirm the API is reachable:
esheria --version
esheria health --format json
esheria ready --format json
- Discover packs, choose a
domain_pack_id, then pass that pack ID to pack-specific commands:
esheria packs list --format json
export ESHERIA_PACK_ID="UK-DATA-PROTECTION-PRIVACY"
esheria packs inspect "$ESHERIA_PACK_ID" --format json
esheria packs versions "$ESHERIA_PACK_ID" --format json
esheria packs diff "$ESHERIA_PACK_ID" --format json
esheria packs change-events "$ESHERIA_PACK_ID" --format json
esheria obligations list "$ESHERIA_PACK_ID" --limit 3 --format json
esheria penalties list "$ESHERIA_PACK_ID" --limit 5 --format json
esheria legal-review audit "$ESHERIA_PACK_ID" --limit 5 --format json
Output flags can be placed globally or on a leaf command:
esheria --format json packs list
esheria packs list --format json
Use esheria --help and <group> --help to discover the full command tree.
The CLI includes source-watch operations, graph coverage/rebuild operations,
workspace-scoped customer lifecycle commands, and workspace/token/billing
management commands in addition to the read workflows above.
Workspace, token, and billing commands require a management token. Normal
dashboard-created and OAuth connector tokens carry only regulatory:read.
State-changing regulatory workflows require an explicitly created operator
data token with one or more of monitoring:write, graph:write, or
customer:write; regulatory:read alone is rejected. For example:
esheria tokens create \
--name "Monitoring operator" \
--scope regulatory:read \
--scope monitoring:write \
--pack UK-DATA-USE-AND-ACCESS
The dashboard remains the recommended place for self-serve workspace, token, billing, and subscription administration. Keep operator tokens short-lived and grant only the scopes and pack entitlements they require.
The CLI and MCP server are catalog-first: users list packs and then call tools
with the explicit pack ID they want. ESHERIA_DEFAULT_PACK_ID is an optional
client preference, not a server-side jurisdiction default.
The CLI reports the API's readiness labels, limitations, citations, and trace IDs; preserve them in downstream workflows. Published packs may represent a reviewed subset of the full legal corpus, and evaluator-gated claim verification is not available for every pack. Esheria output is regulatory intelligence, not legal advice or a substitute for qualified counsel.
Hosted MCP
Production MCP uses the hosted Esheria endpoint:
https://mcp.esheria.ai/mcp
Use this endpoint for normal customer onboarding. It avoids local Python, uvx,
virtual environments, and package discovery on the user's machine.
Claude Directory hosts use OAuth. Other agent hosts send a dashboard-created
Esheria data token as a bearer token or X-API-Key. The hosted MCP server
introspects the credential before initialization and calls the Regulatory Pack
API with it, so billing, pack entitlements, trace IDs, and published-only
behavior remain centralized. Invalid and management-only credentials cannot
enumerate tools.
Codex MCP
Set the token where Codex can read it:
export ESHERIA_API_KEY="<client-api-key>"
Edit ~/.codex/config.toml and add:
[mcp_servers.esheria]
url = "https://mcp.esheria.ai/mcp"
bearer_token_env_var = "ESHERIA_API_KEY"
Restart Codex, then call esheria_health, esheria_ready, and
esheria_list_packs.
Local MCP Fallback
For local development, or for agent hosts that do not support remote MCP URLs, you can run the stdio server yourself:
esheria-mcp serve --stdio
Operator-only HTTP transport command:
ESHERIA_API_BASE_URL="https://api.esheria.ai" \
esheria-mcp serve --http --host 127.0.0.1 --port 8081 --path /mcp
Production is already deployed at https://mcp.esheria.ai/mcp; end users
should not run this command.
The hosted OAuth profile exposes a read-only 20-tool catalog for health, readiness, pack discovery, obligations, applicability, claim verification, versions, diffs, change events, filing calendars, evidence, penalties, audit metadata, relationship queries, exports, and citation context. Normal API data tokens expose 29 safe read/read-like tools. Operator data tokens add only mutations authorized by monitoring:write, graph:write, and/or customer:write, up to the complete 37-tool catalog. Every mutation
also requires confirm=true; OAuth Directory sessions remain read-only.
The hosted service uses the official MCP SDK and current Streamable HTTP.
Successful tools mirror bounded JSON in text content and structuredContent,
with trace_id and mcp truncation metadata. Use the API or CLI when a
complete large export is needed.
Use stdio only for hosts that do not support remote MCP URLs:
[mcp_servers.esheria]
command = "uvx"
args = ["--from", "esheria", "esheria-mcp", "serve", "--stdio"]
env = { ESHERIA_API_BASE_URL = "https://api.esheria.ai", ESHERIA_API_KEY = "<client-api-key>" }
Claude Code
Use Claude Code's remote MCP setup when your installed version exposes it:
- URL:
https://mcp.esheria.ai/mcp - Authorization:
Bearer <client-api-key>
If your Claude Code version only supports local stdio MCP servers, run this fallback once from a terminal:
claude mcp add --scope user --transport stdio \
--env ESHERIA_API_BASE_URL=https://api.esheria.ai \
--env ESHERIA_API_KEY=<client-api-key> \
esheria -- uvx --from esheria esheria-mcp serve --stdio
Then run:
claude mcp list
Start or restart Claude Code and ask it to use the Esheria MCP tools.
Claude Desktop
Use Claude Desktop's remote MCP setup when your installed version exposes it:
- URL:
https://mcp.esheria.ai/mcp - Authorization:
Bearer <client-api-key>
If your Claude Desktop version only supports local stdio MCP servers, use the fallback below.
Open the Claude Desktop MCP config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add or merge this object:
{
"mcpServers": {
"esheria": {
"command": "uvx",
"args": ["--from", "esheria", "esheria-mcp", "serve", "--stdio"],
"env": {
"ESHERIA_API_BASE_URL": "https://api.esheria.ai",
"ESHERIA_API_KEY": "<client-api-key>"
}
}
}
}
Restart Claude Desktop after saving the file.
Questions sur Esheria Regulatory Intelligence MCP
Comment ajouter Esheria Regulatory Intelligence MCP à Claude Code ?
Exécutez claude mcp add --env 'ESHERIA_API_KEY=<YOUR_ESHERIA_API_KEY>' esheria-python -- uvx esheria dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Esheria Regulatory Intelligence MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Esheria remplace-t-il un avis juridique ?
Non, Esheria fournit une intelligence réglementaire et non des conseils juridiques.
Comment configurer l'Esheria CLI ?
Vous pouvez configurer votre shell en exportant les variables d'environnement ESHERIA_API_BASE_URL et ESHERIA_API_KEY.
Quelle est la différence entre les tokens normaux et les tokens opérateurs ?
Les tokens normaux ne possèdent que les permissions regulatory:read, tandis que les tokens opérateurs permettent des workflows de modification d'état avec des scopes tels que monitoring:write, graph:write ou customer:write.