Skip to main content

Connect / AWS AgentCore Gateway

Connect OntoRamp to AWS AgentCore Gateway

Attach OntoRamp servers as MCP server targets in Amazon Bedrock AgentCore.

For AWS customers using Amazon Bedrock AgentCore (pay-as-you-go).

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

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.In the AgentCore Identity console, under Outbound Auth, choose Add OAuth client / API key → Add API key. Name it, paste your OntoRamp key, and choose Add. Note the credential provider ARN shown on the key’s properties page.
  2. 2.In the AgentCore console, open Gateways and select an existing gateway (or create one first).
  3. 3.In the Targets section choose Add, select the MCP server target type, and paste the OntoRamp server URL as the endpoint.
  4. 4.Under outbound authorization, select API key and your credential provider, then set Credential location to HEADER, Credential parameter name to Authorization, and Credential prefix to Bearer.
  5. 5.Choose Add target. The OntoRamp tools join the gateway’s catalog (prefixed with your target name), and your agents reach them through the gateway’s MCP URL.

AWS CLI

aws bedrock-agentcore-control create-api-key-credential-provider \
  --name ontoramp-api-key --api-key YOUR_API_KEY

aws bedrock-agentcore-control create-gateway-target \
  --gateway-identifier YOUR_GATEWAY_ID --name OntoRampGraphQuery \
  --target-configuration '{"mcp":{"mcpServer":{"endpoint":"https://ontoramp-graph-query.fly.dev/mcp"}}}' \
  --credential-provider-configurations '[{"credentialProviderType":"API_KEY",
    "credentialProvider":{"apiKeyCredentialProvider":{
      "providerArn":"YOUR_PROVIDER_ARN",
      "credentialLocation":"HEADER",
      "credentialParameterName":"Authorization",
      "credentialPrefix":"Bearer"}}}]'

Set the credential parameter name to Authorization with prefix Bearer — AWS examples default to x-api-key, which OntoRamp servers do not accept.

YOUR_PROVIDER_ARN is the ARN returned by the first command (also shown on the key’s properties page in the Identity console).

The gateway snapshots the tool list when the target is created. If OntoRamp tools change later, call SynchronizeGatewayTargets to refresh the catalog.

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.

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