Prospect Intelligence

by io.github.truepointmarketingpartners-dotcom

Enriched company lookup

enriched_lookup

Read-onlyIdempotent

Prospecting record: everything in basic_lookup plus buying signals (90 days of news, SEC filings), open roles from public job boards, a 0-100 ICP fit score with stated reasons (optional icp input), a sales brief built only from cited facts, recommended next actions and roles to target (no invented names). Every item cites its source. Price: $0.75 USDC on Base per call via x402; this MCP call returns payment instructions and the paid HTTP route POST /v1/enriched returns the record. Read-only.

Input Schema

Name	Required	Description
`icp`	No	Optional ideal-customer profile for icp_fit: size_ranges (e.g. ["51-200"]), industries (keywords), countries (ISO-2).
`domain`	No	Optional company website domain without https, for example stripe.com. Improves accuracy and enables the public website crawl.
`company`	Yes	Company name, for example "Stripe".

Output Schema

Name	Required	Description
`tool`	Yes	Tool name.
`result`	No	Paid result: basic_lookup fields plus buying_signals { status, value[] }, hiring { open_roles, top_departments, source_url }, icp_fit { score, verdict, reasons[] }, sales_brief { points[] }, recommended_actions[], key_contact_roles, decision_makers. Every item has a source_url.
`status`	Yes	payment_required: pay the HTTP route with x402 to get the result. ok: result is included.
`message`	Yes	Human-readable summary.
`payment`	No	Payment instructions. MCP tools/call does not charge or run the paid work; call the HTTP route with x402.

Schema Changelog

Changes observed during successful MCP inspections.

Changed12 schema fields changedOct 14, 2026

addedInput schema / properties / icp

Added value: +{
+  "description": "Optional ideal-customer profile for icp_fit: size_ranges (e.g. [\"51-200\"]), industries (keywords), countries (ISO-2).",
+  "properties": {
+    "countries": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "industries": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "size_ranges": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

changedOutput schema / properties / result / description

Previous value: -"Paid result: enriched company record with source URLs."New value: +"Paid result: basic_lookup fields plus buying_signals { status, value[] }, hiring { open_roles, top_departments, source_url }, icp_fit { score, verdict, reasons[] }, sales_brief { points[] }, recommended_actions[], key_contact_roles, decision_makers. Every item has a source_url."

addedOutput schema / properties / result / properties / buying_signals
```
Added value: +{
+  "type": "object"
+}
```

addedOutput schema / properties / result / properties / company / properties

Added value: +{
+  "domain": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "entity": {
+    "type": [
+      "object",
+      "null"
+    ]
+  },
+  "firmographics": {
+    "properties": {
+      "employee_count": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "founded_year": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "hq_city": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "hq_country": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "industry": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "linkedin_url": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "official_name": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "size_range": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "ticker": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "website_domain": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      },
+      "x_url": {
+        "properties": {
+          "checked_at": {
+            "type": "string"
+          },
+          "confidence": {
+            "enum": [
+              "high",
+              "medium",
+              "low",
+              null
+            ],
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "value": {}
+        },
+        "type": "object"
+      }
+    },
+    "type": "object"
+  },
+  "name": {
+    "type": "string"
+  },
+  "summary": {
+    "type": [
+      "string",
+      "null"
+    ]
+  }
+}

addedOutput schema / properties / result / properties / decision_makers
```
Added value: +{
+  "type": "object"
+}
```
addedOutput schema / properties / result / properties / hiring
```
Added value: +{
+  "type": "object"
+}
```
addedOutput schema / properties / result / properties / icp_fit
```
Added value: +{
+  "type": "object"
+}
```
addedOutput schema / properties / result / properties / key_contact_roles
```
Added value: +{
+  "type": "object"
+}
```

addedOutput schema / properties / result / properties / recommended_actions

Added value: +{
+  "items": {
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / result / properties / sales_brief
```
Added value: +{
+  "type": "object"
+}
```

removedOutput schema / properties / result / properties / sources

Removed value: -{
-  "items": {
-    "type": "object"
-  },
-  "type": "array"
-}

addedOutput schema / properties / result / properties / version
```
Added value: +{
+  "type": "string"
+}
```

First observedOct 12, 2026

TDQS

A4.4/5.0

Behavior5/5

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

Annotations already declare read-only/idempotent/open-world, and the description adds material behavior the annotations cannot: the x402 payment requirement ($0.75 USDC on Base), the fact that this MCP call returns payment instructions rather than the record, and that the actual data comes from POST /v1/enriched. It also commits to sourcing guarantees (every item cited, no invented names), which tells the agent how much to trust the output.

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?

The record contents are front-loaded and the payment mechanics come last, which matches what an agent needs first. It is a single dense run-on sentence, but nearly every clause carries distinct information (contents, optionality, price, routing, read-only) rather than filler.

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

Completeness5/5

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

An output schema exists so return values need no explanation, and the description still covers the non-obvious parts: cost, the two-step payment-then-HTTP flow, optional icp input, and citation guarantees. Nothing an agent needs to call this correctly or interpret the response appears to be missing.

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 the nested icp object, domain, and company are already documented with examples and semantics. The description only restates that icp is optional and that domain improves accuracy, adding little beyond the schema. Baseline 3 is appropriate when the schema carries the load.

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 resource (enriched prospecting record) and enumerates its contents: buying signals, job-board roles, ICP fit score, cited sales brief, next actions. It explicitly positions itself relative to the sibling basic_lookup ('everything in basic_lookup plus...'), so an agent can distinguish them without opening either schema.

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?

The 'everything in basic_lookup plus' framing plus the explicit $0.75 price gives a clear cost/richness tradeoff for choosing this over the cheaper sibling. It does not, however, name prospect_brief or state exclusions such as when the paid route is unnecessary, so the guidance stops short of explicit when-not-to-use.

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

All Prospect Intelligence tools Inspect

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.