dVeracity Semantic API — Claude Code MCP server: features and setup
Query a verified emissions knowledge graph in natural language and validate payloads against supported standards. Useful when building with Open Footprint or checking emissions data.
claude mcp add --transport http semantic-mcp https://api.dveracity.com/mcpWhat dVeracity Semantic API does
The server lets an agent ask questions about verified emissions data, browse supported query templates, and validate payloads against standards. Its Open Footprint tools can inspect the canonical model, find entities, and check data against the model and sector rules.
Paid calls require an api-tier subscription, an API key, and credits. Without those, credit-metered queries and validations cannot run. Claude Code can connect to the hosted HTTP server with the command below. Optional KERI mode adds verifiable agent identity and requires the agent’s credentials and configuration.
What it helps with
- find an entity in the Open Footprint model
- browse supported query templates
- validate a payload against a standard
- check data against sector rules
- check the remaining API credit balance
Example prompts for the agent
- Find the Open Footprint entity for emissions data.
- Validate this payload against the supported standards and explain the result.
- Show me the query templates available for the emissions graph.
How to install dVeracity Semantic API
1Platform CLI: remote server
claude mcp add --transport http semantic-mcp https://api.dveracity.com/mcp2Platform CLI
claude mcp add --env DVERACITY_API_KEY=<DVERACITY_API_KEY> --env DVERACITY_API_URL=<DVERACITY_API_URL> --env DVERACITY_KERI_AID=<DVERACITY_KERI_AID> --env DVERACITY_KERI_PRESENTATION=<DVERACITY_KERI_PRESENTATION> --transport stdio dveracity-semantic-api -- npx -y @dveracity/semantic-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add dveracity-semantic-api --url https://api.dveracity.com/mcp2Platform CLI
codex mcp add dveracity-semantic-api --env DVERACITY_API_KEY=<DVERACITY_API_KEY> --env DVERACITY_API_URL=<DVERACITY_API_URL> --env DVERACITY_KERI_AID=<DVERACITY_KERI_AID> --env DVERACITY_KERI_PRESENTATION=<DVERACITY_KERI_PRESENTATION> -- npx -y @dveracity/semantic-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"dveracity-semantic-api": {
"url": "https://api.dveracity.com/mcp"
}
}
}{
"mcpServers": {
"dveracity-semantic-api": {
"command": "npx",
"args": [
"-y",
"@dveracity/semantic-mcp"
],
"env": {
"DVERACITY_API_KEY": "<DVERACITY_API_KEY>",
"DVERACITY_API_URL": "<DVERACITY_API_URL>",
"DVERACITY_KERI_AID": "<DVERACITY_KERI_AID>",
"DVERACITY_KERI_PRESENTATION": "<DVERACITY_KERI_PRESENTATION>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"dveracity-semantic-api": {
"type": "http",
"url": "https://api.dveracity.com/mcp"
}
}
}{
"servers": {
"dveracity-semantic-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dveracity/semantic-mcp"
],
"env": {
"DVERACITY_API_KEY": "<DVERACITY_API_KEY>",
"DVERACITY_API_URL": "<DVERACITY_API_URL>",
"DVERACITY_KERI_AID": "<DVERACITY_KERI_AID>",
"DVERACITY_KERI_PRESENTATION": "<DVERACITY_KERI_PRESENTATION>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http dveracity-semantic-api https://api.dveracity.com/mcp2Platform CLI
gemini mcp add -e DVERACITY_API_KEY=<DVERACITY_API_KEY> -e DVERACITY_API_URL=<DVERACITY_API_URL> -e DVERACITY_KERI_AID=<DVERACITY_KERI_AID> -e DVERACITY_KERI_PRESENTATION=<DVERACITY_KERI_PRESENTATION> dveracity-semantic-api npx -y @dveracity/semantic-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about dVeracity Semantic API
How do I install dVeracity Semantic API in Claude Code?
Run claude mcp add --transport http semantic-mcp https://api.dveracity.com/mcp. Paid calls also require an api-tier subscription, an API key, and credits.
What does dVeracity Semantic API do?
It gives agents natural-language access to a verified emissions knowledge graph and tools to validate payloads against supported standards. It also includes tools for exploring and checking the Open Footprint model.
What do I need to make paid calls?
You need an api-tier subscription, an API key, and credits for metered calls. Some Open Footprint model tools and other tools are free.
