Skip to main content

Connect / VS Code

Connect OntoRamp to VS Code

Add OntoRamp to VS Code (GitHub Copilot agent mode) via mcp.json.

Works with GitHub Copilot in VS Code 1.102 or later, including Copilot Free.


Before you start

You need an OntoRamp API key — get one free at ontoramp.com/mcp. Keys arrive by email within 60 seconds and are passed as a Bearer token in the Authorization header: Authorization: Bearer YOUR_API_KEY. If your tool asks for an API key directly, paste just the key — the header is added for you.

Server URLs

OntoRamp Graph Query5 tools
https://ontoramp-graph-query.fly.dev/mcp

MCP Registry: com.ontoramp/graph-query

OntoRamp Decision Intelligence4 tools
https://ontoramp-decision-intelligence.fly.dev/mcp

MCP Registry: com.ontoramp/decision-intelligence

OntoRamp Transformation Radar3 tools
https://ontoramp-transformation-radar.fly.dev/mcp

MCP Registry: com.ontoramp/transformation-radar

OntoRamp Knowledge Cartographer5 tools
https://ontoramp-knowledge-cartographer.fly.dev/mcp

MCP Registry: com.ontoramp/knowledge-cartographer

OntoRamp Platform11 tools
https://mcp.ontoramp.com/mcp

Setup

Each server in the table above is its own connection — repeat the setup (or add another config entry) for each one you want.

  1. 1.Create or open .vscode/mcp.json in your workspace (or run MCP: Open User Configuration from the Command Palette for a user-level setup).
  2. 2.Add the OntoRamp server using the snippet below — the inputs block prompts for your key once and stores it masked, instead of hardcoding it.
  3. 3.Save, then click Start above the server entry (accept the trust dialog) and enter your key when prompted.
  4. 4.Open Chat (Ctrl+Alt+I, or Ctrl+Cmd+I on macOS), switch to Agent, and click Configure Tools to confirm the OntoRamp tools are enabled.

.VSCODE/MCP.JSON

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ontoramp-key",
      "description": "OntoRamp API Key",
      "password": true
    }
  ],
  "servers": {
    "ontoramp-graph-query": {
      "type": "http",
      "url": "https://ontoramp-graph-query.fly.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${input:ontoramp-key}"
      }
    }
  }
}

On Copilot Business or Enterprise, an admin must enable the “MCP servers in Copilot” policy (off by default) before MCP tools work.


Tools you get

OntoRamp Graph Query

query_architectureSemantic search across your architecture and governance graph.
find_dependenciesDependency paths and coupling signals for any system, process, or capability.
get_constraint_signalsGovernance constraints relevant to a proposed action.
get_evidence_for_claimEvidence that supports or contradicts a claim or rationale.
request_assessmentSubmit an Agentic Readiness Assessment request. Free on any tier.

OntoRamp Decision Intelligence

log_decisionWrite a consequential decision to your governed decision record.
find_decision_precedentSearch your decision history for precedents with authority signals.
evaluate_decisionEvaluate a proposed decision against your authority context. Returns PASS, WARN, or BLOCK.
request_assessmentSubmit an Agentic Readiness Assessment request. Free on any tier.

OntoRamp Transformation Radar

get_maturity_gapDomain-by-domain maturity gap score against the governance baseline.
get_initiative_riskInitiative-level risk signals for your transformation portfolio.
request_assessmentSubmit an Agentic Readiness Assessment request. Free on any tier.

OntoRamp Knowledge Cartographer

get_coverage_mapDomain-by-domain map of your organization’s knowledge coverage.
get_knowledge_health_scoreA single 0–100 knowledge-health score with gap signals.
detect_knowledge_gapsPrioritized list of knowledge gaps and what to ingest next.
ingest_documentSubmit a plain-text document into your governed knowledge graph.
request_assessmentSubmit an Agentic Readiness Assessment request. Free on any tier.

OntoRamp Platform

semantic_searchSearch governance and compliance knowledge by meaning.
keyword_searchExact-match search across the governance knowledge base.
hybrid_searchCombined semantic and keyword search for highest-relevance results.
entity_searchSearch governance entities and their relationships.
edge_traversalTrace governance dependencies and control relationships.
get_maturity_gapGovernance maturity gap analysis across 7 domains.
lint_documentValidate a governance document against known frameworks and standards.
generate_briefEvidence-linked governance briefs with full source citations.
get_simulation_statusCheck governance assessment progress and results.
get_decision_packetsDomain-level assessment findings with evidence and rationale.
run_projectionRun a new governance maturity assessment.

Full parameter and response schemas are in the MCP API reference.