dVeracity Semantic API

{
  "name": "dVeracity Semantic API",
  "description": "Verified emissions data and the Open Footprint canonical model, for agents. Eighteen read-only tools over MCP (remote Streamable HTTP with OAuth 2.1, or the stdio npm package): natural-language queries over a verified emissions knowledge graph (metered), the Open Footprint model \u2014 entities, sectors, O-DEF semantics, sector guardrails (free) \u2014 validation of payloads against the model and published guardrails (metered), and approved regulatory compliance policies (paid plans). Credit-billed with machine-readable HTTP 402 semantics; optional vLEI-verified agent identity (GLEIF-rooted Agent Authorization credentials).",
  "url": "https://dveracity.com",
  "provider": {
    "organization": "dVeracity",
    "url": "https://dveracity.com"
  },
  "version": "0.6.2",
  "documentationUrl": "https://dveracity.com/api/v1/semantic/manifest",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "authentication": {
    "schemes": [
      "oauth2",
      "apiKey",
      "keri-vlei"
    ],
    "credentials": "Remote MCP (https://api.dveracity.com/mcp): OAuth 2.1 with PKCE and dynamic client registration \u2014 an unauthenticated handshake answers 401 with a WWW-Authenticate challenge naming the protected-resource metadata; no anonymous access. REST and the stdio package: X-Api-Key (dvrc_ key from a subscribed account \u2014 https://dveracity.com/pricing). Optional verified identity: X-Keri-Session obtained via GET /api/v1/semantic/auth/challenge + POST /api/v1/semantic/auth/keri with a vLEI-chained Agent Authorization credential presentation.",
    "oauth2": {
      "protectedResourceMetadata": "https://api.dveracity.com/.well-known/oauth-protected-resource/mcp",
      "authorizationServerMetadata": "https://api.dveracity.com/.well-known/oauth-authorization-server"
    },
    "scopes": {
      "semantic:query": "natural-language questions (metered)",
      "semantic:templates": "query templates (free)",
      "ofp:read": "Open Footprint model, sectors, guardrails, semantics (free)",
      "ofp:validate": "validation against the model and guardrails (metered)",
      "compliance:read": "approved regulatory compliance policies (paid plans)"
    }
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "semantic_query",
      "name": "semantic_query",
      "description": "Ask a natural-language question about verified emissions data (Open Footprint / PPDM / OGMP-methane knowledge graphs). Cost: metered per credit.",
      "tags": [
        "metered",
        "read-only"
      ]
    },
    {
      "id": "semantic_templates",
      "name": "semantic_templates",
      "description": "List the query templates the semantic layer supports (free). Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "credits_balance",
      "name": "credits_balance",
      "description": "Show the remaining dVeracity API credit balance for this account (free). Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "list_standards",
      "name": "list_standards",
      "description": "List the sustainability data standards dVeracity can validate against (free). Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "validate_data",
      "name": "validate_data",
      "description": "Validate a data payload against a supported sustainability standard (Validation-as-a-Service). Cost: metered per credit.",
      "tags": [
        "metered",
        "read-only"
      ]
    },
    {
      "id": "keri_identity",
      "name": "keri_identity",
      "description": "Show this agent's verified vLEI identity (agent AID, Legal Entity LEI, authorized scopes) if KERI mode is configured \u2014 free. Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "ofp_models",
      "name": "ofp_models",
      "description": "List the eight Open Footprint canonical model domains and which database dialects have published DDL (free). Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "ofp_search_entities",
      "name": "ofp_search_entities",
      "description": "Search the 239 canonical Open Footprint entities by concept (free). Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "ofp_entity",
      "name": "ofp_entity",
      "description": "Get one canonical entity in full (free): fields with types and required flags, primary key, relationships, and the physical database table implementing it. Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "ofp_sectors",
      "name": "ofp_sectors",
      "description": "List industry sectors and their reference implementations (free). Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "ofp_sector",
      "name": "ofp_sector",
      "description": "Get one sector in full (free): its classification, status, reference artifacts and nested industries. Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "ofp_policies",
      "name": "ofp_policies",
      "description": "Get a sector's policy guardrails as Rego source (free), with policies[].inputs listing the record types and input fields each policy reads \u2014 e-ledger fields such as co2e_kg and direction, not canonical Open Footprint fie Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "compliance_policies",
      "name": "compliance_policies",
      "description": "List APPROVED regulatory compliance policies \u2014 rules AI-extracted from a regulation (for example EU Green Bonds, CSRD/ESRS) and approved by a dVeracity admin. Cost: paid plans (VaaS and above).",
      "tags": [
        "paid",
        "read-only"
      ]
    },
    {
      "id": "compliance_policy",
      "name": "compliance_policy",
      "description": "One APPROVED regulatory compliance policy in full: its Rego source, the structured rules the extractor produced, the record types and input fields the Rego reads, and provenance (source regulation document, extraction mo Cost: paid plans (VaaS and above).",
      "tags": [
        "paid",
        "read-only"
      ]
    },
    {
      "id": "ofp_validate",
      "name": "ofp_validate",
      "description": "Check a data payload against the canonical Open Footprint model and, when a sector is named, that sector's published Rego guardrails. Cost: metered per credit.",
      "tags": [
        "metered",
        "read-only"
      ]
    },
    {
      "id": "ofp_semantics",
      "name": "ofp_semantics",
      "description": "List the O-DEF semantic codes carried by the canonical model (free). Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "ofp_semantic_code",
      "name": "ofp_semantic_code",
      "description": "Show which canonical fields carry one O-DEF semantic code (free). Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    },
    {
      "id": "ofp_model_provenance",
      "name": "ofp_model_provenance",
      "description": "Show which snapshot of the Open Footprint standard this deployment serves (free): source commit, date, and entity/sector counts. Cost: free.",
      "tags": [
        "free",
        "read-only"
      ]
    }
  ],
  "interfaces": {
    "manifest": "https://dveracity.com/api/v1/semantic/manifest",
    "mcp": {
      "remote": {
        "transport": "streamable-http",
        "url": "https://api.dveracity.com/mcp",
        "auth": "oauth2"
      },
      "serverCard": "https://api.dveracity.com/.well-known/mcp/server-card.json",
      "package": "@dveracity/semantic-mcp",
      "registry": "npm",
      "transport": "stdio",
      "mcpRegistry": "com.dveracity/semantic-mcp",
      "sourceMirror": "https://github.com/d-veracity/semantic-mcp"
    },
    "privacy": "https://dveracity.com/privacy",
    "terms": "https://dveracity.com/terms",
    "support": "https://dveracity.com/support",
    "security": "https://dveracity.com/.well-known/security.txt",
    "trust": "https://dveracity.com/trust"
  }
}