GovInbox

Teaming partner finder

find_teaming_partners

Read-onlyIdempotent

Not affiliated with the U.S. government, GSA, or SAM.gov. Not a U.S. government service. Prime contractors with a recorded track record of subcontracting in a NAICS lane, ranked by their small-business subaward history. For a small business looking for teaming conversations: which primes have actually used subs in your lane. Results are historical facts from reported subaward filings, inclusion is NOT a statement that a prime is seeking partners, has openings, or would be interested in any particular firm. WARNING: teaming with a large business can trigger affiliation rules that cost you your small business or set-aside eligibility (SDVOSB, 8(a), HUBZone). Size status shown is UNVERIFIED - check SAM.gov before relying on it. Exclusion screening is not established here; verify current status in SAM.gov. Present as information only; do not frame results as a bid/no-bid recommendation, eligibility determination, or partnership recommendation. Follow-ups within 30 minutes after a search ride free (up to 30 per search); otherwise one accepted call counts as one use, regardless of how many records are returned. Every record carries a direct source link (or source name and record ID) so you can verify and cite the underlying record.

Input Schema

Name	Required	Description
`limit`	No
`naics`	No	Your NAICS codes, 2-6 digits each; primes are ranked on subcontracting in these lanes. Omit for all lanes
`state`	No	Subaward place-of-performance state code, e.g. VA
`agency`	No	Awarding agency name substring filter
`certifications`	No	Narrow to primes with subawards to subs holding these certifications: small, 8a, hubzone, sdvosb, vosb, veteran, wosb, edwosb, sdb

Output Schema

Name	Required	Description	Default
`count`	Yes
`quota`	Yes
`primes`	Yes
`coverage`	Yes
`data_caveat`	No	Data quality caveat	Prime names and amounts are as reported in subaward filings, often incomplete or duplicated; they are not cash paid and not obligations. Inclusion means the prime has reported subcontracting activity in this lane -- it is not a statement that the prime is seeking partners or would be interested in any particular firm. Not a partnership suggestion.
`analytical_disclaimer`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed33 schema fields changedOct 24, 2026

addedOutput schema / $defs / Coverage / properties / as_of / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / $defs / Coverage / properties / as_of / default
```
Added value: +null
```

changedOutput schema / $defs / Coverage / properties / as_of / description

Previous value: -"UTC ISO 8601"New value: +"Known source observation time; null when not recorded. Not the query time."

removedOutput schema / $defs / Coverage / properties / as_of / type
```
Removed value: -"string"
```

addedOutput schema / $defs / Coverage / properties / cache_timestamp_basis

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Cache Timestamp Basis"
+}

addedOutput schema / $defs / Coverage / properties / cache_timestamp_field

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Cache Timestamp Field"
+}

addedOutput schema / $defs / Coverage / properties / exclusions

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "title": "Exclusions",
+  "type": "array"
+}

addedOutput schema / $defs / Coverage / properties / last_attempt_at

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Last Attempt At"
+}

addedOutput schema / $defs / Coverage / properties / last_attempt_scope

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Last Attempt Scope"
+}

addedOutput schema / $defs / Coverage / properties / last_success_record_count

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Last Success Record Count"
+}

addedOutput schema / $defs / Coverage / properties / last_success_scope

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Last Success Scope"
+}

addedOutput schema / $defs / Coverage / properties / last_successful_ingest_at

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Last Successful Ingest At"
+}

addedOutput schema / $defs / Coverage / properties / last_successful_refresh_at

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Last Successful Refresh At"
+}

addedOutput schema / $defs / Coverage / properties / latest_cached_at

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Latest Cached At"
+}

addedOutput schema / $defs / Coverage / properties / latest_stored_fetched_at

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Latest Stored Fetched At"
+}

addedOutput schema / $defs / Coverage / properties / latest_stored_ingested_at

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Latest Stored Ingested At"
+}

addedOutput schema / $defs / Coverage / properties / oldest_cached_at

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Oldest Cached At"
+}

addedOutput schema / $defs / Coverage / properties / oldest_ingested_at

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Oldest Ingested At"
+}

addedOutput schema / $defs / Coverage / properties / pagination_note

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Pagination Note"
+}

addedOutput schema / $defs / Coverage / properties / population

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Population"
+}

addedOutput schema / $defs / Coverage / properties / population_complete

Added value: +{
+  "default": false,
+  "title": "Population Complete",
+  "type": "boolean"
+}

addedOutput schema / $defs / Coverage / properties / population_status

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Population Status"
+}

addedOutput schema / $defs / Coverage / properties / query_time

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "When this stored-data query was calculated; not proof of source refresh",
+  "title": "Query Time"
+}

addedOutput schema / $defs / Coverage / properties / record_type

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Record Type"
+}

addedOutput schema / $defs / Coverage / properties / refresh_error_code

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Refresh Error Code"
+}

addedOutput schema / $defs / Coverage / properties / refresh_status

Added value: +{
+  "default": "unknown",
+  "title": "Refresh Status",
+  "type": "string"
+}

addedOutput schema / $defs / Coverage / properties / scope_note

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Scope Note"
+}

addedOutput schema / $defs / Coverage / properties / source

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Source"
+}

addedOutput schema / $defs / Coverage / properties / source_as_of

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Source As Of"
+}

addedOutput schema / $defs / Coverage / properties / source_state

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "matched",
+        "no_match",
+        "not_loaded",
+        "unsupported",
+        "failed_refresh",
+        "unknown"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Source State"
+}

addedOutput schema / $defs / Coverage / properties / source_url

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Source Url"
+}

addedOutput schema / $defs / Coverage / properties / stored_rows

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Stored Rows"
+}

removedOutput schema / $defs / Coverage / required
```
Removed value: -[
-  "as_of"
-]
```

Changed1 schema field changedOct 18, 2026

addedOutput schema / $defs / QuotaBlock / properties / mode

Added value: +{
+  "default": "ordinary",
+  "enum": [
+    "ordinary",
+    "testing",
+    "review",
+    "beta"
+  ],
+  "title": "Mode",
+  "type": "string"
+}

First observedOct 14, 2026

TDQS

A3.8/5.0

Behavior5/5

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

Annotations already establish read-only, idempotent, non-destructive behavior, and the description still adds substantial non-obvious context: results are historical facts from reported subaward filings, inclusion does not imply a prime is seeking partners, size status is UNVERIFIED and must be checked in SAM.gov, exclusion screening is not established, and every record carries a source link for citation. It also discloses the billing/rate-limit model (free follow-ups within 30 minutes, otherwise one call per use).

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

Conciseness3/5

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

The core purpose sentence arrives after two near-duplicate disclaimers ('Not affiliated with the U.S. government, GSA, or SAM.gov. Not a U.S. government service.'), which is wasted front-load. The remainder is dense but mostly earns its place: affiliation-rule warning, unverified size status, and the rate-limit sentence.

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?

With an output schema present and annotations covering safety, the description needs only to frame interpretation, scope, and limits, which it does thoroughly. The one gap versus sibling differentiation (find_partners) is a routing concern rather than a completeness-of-calling concern, keeping it just under a 5.

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 coverage is 80%, so the schema already documents naics, state, agency, and certifications well, and the description adds only the framing that rankings are on subcontracting in 'these lanes.' It adds nothing on limit, on the state/place-of-performance semantics, or on how certification filters interact with the ranking, so it does not exceed the baseline for a high-coverage schema.

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

Purpose4/5

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

The description states a specific verb and resource: primes with a recorded subcontracting track record in a NAICS lane, ranked by small-business subaward history. That is far more precise than the title. It does not, however, distinguish itself from the overlapping sibling find_partners, so an agent cannot tell which of the two to call from this text alone.

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

Usage Guidelines3/5

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

It gives a clear usage context ('For a small business looking for teaming conversations: which primes have actually used subs in your lane') and firm interpretation limits ('do not frame results as a bid/no-bid recommendation, eligibility determination, or partnership recommendation'). But it never names an alternative tool or says when not to call this in favor of find_partners, which is the obvious sibling in this space.

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

All GovInbox 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.

Resources

Need Help?