# dVeracity Semantic API

> dVeracity Semantic API is a freemium MCP server for analytics and data. Query verified emissions data and validate payloads against Open Footprint. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://dveracity.com/semantic-api
- **Repository:** https://github.com/d-veracity/semantic-mcp
- **MCP Registry name:** com.dveracity/semantic-mcp
- **Categories:** analytics and data
- **Listing updated:** 2026-11-14

## About

Behind the server sits a knowledge graph of verified emissions records: the site says it holds more than 24,900 methane detection events plus thousands of sites, companies and reports. Questions are asked in plain language, for example total verified Scope 1 emissions for a facility by period, or which countries had the most detected methane plumes.

A second job is validation. The server can check a payload against the Open Footprint data model and report what fails, and the registry entry also mentions EU CBAM record checks. Signed compliance certificates exist, but they cost 500 credits and fall outside the free allowance.

Calls are metered in credits. When an account runs out, the API answers HTTP 402 with the balance, the credits needed and a purchase pointer, so an agent can pass that to its operator instead of retrying. An optional mode attaches a vLEI-backed agent identity so each call is attributed to a legal entity in the audit trail.

## Features

- **Natural-language emissions queries:** Ask questions over a verified emissions knowledge graph and get answers an agent can act on.
- **Open Footprint validation:** Check a payload against the Open Footprint model and list what fails.
- **Credit metering with 402 replies:** Out-of-credit calls return a machine-readable balance and purchase pointer.
- **Verified agent identity:** Optional KERI credential mode ties each call to an agent and its legal entity.
- **Free helper tools:** Template catalogue, credit balance, supported standards and identity lookups cost nothing.

## Good for

- Pull verified Scope 1 totals for a facility by period
- Check a data payload against the Open Footprint standard before submitting it
- Find which operators are linked to detected methane plumes
- Keep an audit trail of which agent touched emissions data

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http semantic-mcp https://api.dveracity.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.dveracity.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "semantic-mcp": {
      "url": "https://api.dveracity.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "semantic-mcp": {
      "type": "http",
      "url": "https://api.dveracity.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "semantic-mcp": {
      "serverUrl": "https://api.dveracity.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "semantic-mcp": {
      "type": "http",
      "url": "https://api.dveracity.com/mcp"
    }
  }
}
```

## Tools

- `semantic_query`: Natural-language question over the verified-emissions knowledge graph
- `semantic_templates`: Catalog of supported query templates
- `credits_balance`: Remaining credit balance
- `list_standards`: Standards VaaS can validate against
- `validate_data`: Validate a payload against a supported standard
- `keri_identity`: The agent's verified vLEI identity when KERI mode is configured
- `billing_plans`: Plans, credit packs and the free allowance
- `billing_status`: Account plan, balance and remaining free allowance
- `billing_purchase`: One-time credit checkout link
- `billing_subscribe`: Membership checkout link

## FAQ

### How is it billed?

Metered calls use prepaid credits at $0.01 each. A free Explorer plan gives 100 metered calls a month, for calls costing up to one credit each.

### What does the stdio package need?

A dVeracity API key (dvrc_...) in DVERACITY_API_KEY. The remote endpoint at api.dveracity.com/mcp uses OAuth instead.

### Which tools are free?

semantic_templates, credits_balance, list_standards and keri_identity are listed as free; semantic_query and validate_data use credits.

### What happens when credits run out?

The API returns HTTP 402 with the balance, credits needed and a purchase endpoint.

### Is dVeracity Semantic API free?

dVeracity Semantic API has a free plan, with paid plans for more usage or features.

### How do I add dVeracity Semantic API to Claude Code?

Run this command in your terminal: claude mcp add --transport http semantic-mcp https://api.dveracity.com/mcp

### What are the best alternatives to dVeracity Semantic API?

The closest alternatives to dVeracity Semantic API are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/dveracity-semantic-api
