Skip to main content
Glama

RAVN

by exchange.ravn
OverviewDiscussionsAdmin

How many BTC venues list each token

ravn_btc_coverage
Read-only

For a swap where native BTC is the source: how many BTC venues list each of ravn_tokens's tokens on chainId. A ranking hint (a token more venues list is more likely to keep routing through one venue's outage), not a gate: ravn_quote decides, and tokens off RAVN's list route from BTC too. BTC-as-source only.

Input Schema

NameRequiredDescriptionDefault
apiKeyNoYour RAVN API key, if you have one — raises your rate limit
chainIdYesThe destination chain to check BTC-source coverage on

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "chainId": {
-            "description": "Echoes the requested chain",
-            "type": "number"
-          },
-          "coverage": {
-            "additionalProperties": {
-              "type": "number"
-            },
-            "description": "Token address (lowercase on EVM; a Solana mint exactly as listed, since base58 is case-sensitive) to the number of BTC venues (1-3) that route to it from native Bitcoin. Tokens no venue serves are omitted, not listed at 0",
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "filtered": {
-            "description": "False means the upstream venue lists couldn't be reached right now — coverage is empty and the answer is unknown, not 'nothing routes'. Treat like an outage: don't filter your token list on it",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "chainId",
-          "filtered",
-          "coverage"
-        ],
-        "type": "object"
-      },
-      "meta": {
-        "additionalProperties": false,
-        "properties": {
-          "requestId": {
-            "type": "string"
-          },
-          "version": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "requestId",
-          "version"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "data",
-      "meta"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "details": {},
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "meta": {
-        "additionalProperties": false,
-        "properties": {
-          "requestId": {
-            "type": "string"
-          },
-          "version": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "requestId",
-          "version"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "error",
-      "meta"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "chainId": {
+            "description": "Echoes the requested chain",
+            "type": "number"
+          },
+          "coverage": {
+            "additionalProperties": {
+              "type": "number"
+            },
+            "description": "Token address (lowercase on EVM; a Solana mint exactly as listed, since base58 is case-sensitive) to the number of BTC venues (1-3) that list it, for native Bitcoin as the source. Every RAVN-listed token on the chain is in it",
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "filtered": {
+            "description": "False means the upstream venue lists couldn't be reached right now — coverage is empty and the answer is unknown, not 'nothing routes'. Treat like an outage: don't filter your token list on it",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "chainId",
+          "filtered",
+          "coverage"
+        ],
+        "type": "object"
+      },
+      "meta": {
+        "additionalProperties": false,
+        "properties": {
+          "requestId": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "requestId",
+          "version"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "data",
+      "meta"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "details": {},
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "meta": {
+        "additionalProperties": false,
+        "properties": {
+          "requestId": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "requestId",
+          "version"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "error",
+      "meta"
+    ],
+    "type": "object"
+  }
+]
  2. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "chainId": {
-            "description": "Echoes the requested chain",
-            "type": "number"
-          },
-          "coverage": {
-            "additionalProperties": {
-              "type": "number"
-            },
-            "description": "Lowercased token address to the number of BTC venues (1-3) that route to it from native Bitcoin. Tokens no venue serves are omitted, not listed at 0",
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "filtered": {
-            "description": "False means the upstream venue lists couldn't be reached right now — coverage is empty and the answer is unknown, not 'nothing routes'. Treat like an outage: don't filter your token list on it",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "chainId",
-          "filtered",
-          "coverage"
-        ],
-        "type": "object"
-      },
-      "meta": {
-        "additionalProperties": false,
-        "properties": {
-          "requestId": {
-            "type": "string"
-          },
-          "version": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "requestId",
-          "version"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "data",
-      "meta"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "details": {},
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "meta": {
-        "additionalProperties": false,
-        "properties": {
-          "requestId": {
-            "type": "string"
-          },
-          "version": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "requestId",
-          "version"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "error",
-      "meta"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "chainId": {
+            "description": "Echoes the requested chain",
+            "type": "number"
+          },
+          "coverage": {
+            "additionalProperties": {
+              "type": "number"
+            },
+            "description": "Token address (lowercase on EVM; a Solana mint exactly as listed, since base58 is case-sensitive) to the number of BTC venues (1-3) that route to it from native Bitcoin. Tokens no venue serves are omitted, not listed at 0",
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "filtered": {
+            "description": "False means the upstream venue lists couldn't be reached right now — coverage is empty and the answer is unknown, not 'nothing routes'. Treat like an outage: don't filter your token list on it",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "chainId",
+          "filtered",
+          "coverage"
+        ],
+        "type": "object"
+      },
+      "meta": {
+        "additionalProperties": false,
+        "properties": {
+          "requestId": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "requestId",
+          "version"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "data",
+      "meta"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "details": {},
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "meta": {
+        "additionalProperties": false,
+        "properties": {
+          "requestId": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "requestId",
+          "version"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "error",
+      "meta"
+    ],
+    "type": "object"
+  }
+]
  3. Added

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint and openWorldHint, so the safety profile is covered; the description adds the non-obvious interpretive caveat that coverage is a heuristic hint rather than an eligibility gate, and that RAVN's token list is not exhaustive for BTC-source routing. No claim about result shape or freshness is made, but the output schema carries the return values.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short segments with the core purpose front-loaded before the ranking-hint caveat and the BTC-only constraint. Some clauses are densely packed ("ravn_tokens's tokens") but nothing is redundant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only analytical lookup with a full output schema and complete parameter documentation, the description supplies everything needed to call and interpret it: the source-chain precondition, the input dimension, and the interpretive status of the result. It does not describe freshness or how venue counts are computed, which is a minor gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so both parameters are already documented (apiKey as a rate-limit lifter, chainId as the destination chain). The description only echoes chainId as the scoping dimension and adds no format or semantics beyond the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (counts how many BTC venues list each token on a given chainId) and immediately scopes it to "a swap where native BTC is the source". It also distinguishes itself from ravn_tokens (whose token list it consumes) and ravn_quote (which it explicitly says takes precedence in routing decisions).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly frames the output as "a ranking hint ... not a gate: ravn_quote decides", which tells the agent when not to rely on it, and names the case of tokens off RAVN's list routing from BTC too. Guidance is clear but does not state the positive condition (e.g. "call this when ranking candidate tokens before a quote") as directly as it could.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All RAVN toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources