# dVeracity Semantic API

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: d-veracity
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/d-veracity/semantic-mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/dveracity-semantic-api

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.dveracity.com/mcp`
- Environment variables: `DVERACITY_API_KEY`, `DVERACITY_API_URL`, `DVERACITY_KERI_AID`, `DVERACITY_KERI_PRESENTATION` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http semantic-mcp https://api.dveracity.com/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add dveracity-semantic-api --url https://api.dveracity.com/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dveracity-semantic-api": {
            "url": "https://api.dveracity.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dveracity-semantic-api": {
            "type": "http",
            "url": "https://api.dveracity.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http dveracity-semantic-api https://api.dveracity.com/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md