[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [USAspending recipient profile](https://spiral.ai/integrations/dots/usaspending-recipient-profile)

# How to Use USAspending recipient profile in dots

Get a federal award recipient's names, identifiers, parent organizations, business types, location, and transaction totals from USAspending. Use it to research one organization and compare its federal funding across fiscal years.

|  |  |
| --- | --- |
| Model | USAspending recipient profile |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with USAspending recipient profile in dots

- Every Monday, use USAspending recipient profile for Lockheed Martin Corporation, UEI G4KDGE4JFFK7, for fiscal year 2026. Report changes in transaction amount and count since the previous check.
- Once a month, use USAspending recipient profile for UEI G4KDGE4JFFK7. Tell me whether the returned names, location, or parent organizations changed.
- Every Friday, use USAspending recipient profile for Lockheed Martin Corporation, UEI G4KDGE4JFFK7, for the latest 12 months. Report the total and its change since last week, noting that the reporting window moves.
- On the first day of each month, use USAspending recipient profile for UEI G4KDGE4JFFK7 for fiscal years 2024 and 2025. Flag revisions to either year's published totals.
- Once a month, use USAspending recipient profile for Lockheed Martin Corporation, UEI G4KDGE4JFFK7. Report any changes in its listed business types or recipient level.

## How to set up USAspending recipient profile in dots

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send dots this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run USAspending recipient profile**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "usaspending-gov/recipients/recipient",
    "input": {
      "recipient_id": "<recipient_id>"
    }
  }'
```

Then paste one of the prompts above: dots finds USAspending recipient profile on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/dots

## USAspending recipient profile tools and prices

- [USAspending · Recipient](https://spiral.ai/tools/alexandria/usaspending-gov/recipients/recipient) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| uei |  | — | Resolved through the recipient list endpoint (several seconds upstream); prefer recipient_id when known. Pattern: ^[A-Za-z0-9]{12}$. |
| fiscal_year | 2008 to 2035 | — | Period for the headline totals; omitted = latest trailing 12 months. |
| fiscal_years |  | — | Fiscal years to break obligations down by (one upstream request each). |
| recipient_id |  | — | Pattern: ^[0-9a-fA-F-]{36}-[CPRcpr]$. |

## What can you do with USAspending recipient profile in dots?

Create a recurring report of changes in USAspending's published recipient totals and company details. A scheduled agent can compare the same recipient and fiscal year over time, with reporting delays included in the interpretation.

### Prepare a federal supplier brief

Summarize an organization's reported identity, parent organizations, business types, location, and federal transaction totals before a supplier review.

### Compare annual federal funding

Compare a recipient's totals across completed fiscal years and calculate the annual changes.

### Enrich business account records

Match an existing business account by UEI and add its USAspending identity, location, parent organizations, and transaction totals.

### Check organizational relationships

Review returned parent identifiers and recipient levels before combining company records in a federal supplier analysis.

### Monitor reported funding changes

Compare repeated profiles for the same recipient and fiscal year to identify changes in published transaction amounts or counts.

### Build a supplier comparison

Compare known suppliers using the same fiscal year and recipient level, with transaction totals, counts, and reported business types side by side.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All dots guides](https://spiral.ai/integrations/dots)

## USAspending recipient profile in other agents

- [Amp](https://spiral.ai/integrations/amp/usaspending-recipient-profile)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/usaspending-recipient-profile)
- [Claude](https://spiral.ai/integrations/claude-desktop/usaspending-recipient-profile)
- [Claude Code](https://spiral.ai/integrations/claude-code/usaspending-recipient-profile)
- [Cline](https://spiral.ai/integrations/cline/usaspending-recipient-profile)
- [Codex](https://spiral.ai/integrations/codex/usaspending-recipient-profile)
- [Cursor](https://spiral.ai/integrations/cursor/usaspending-recipient-profile)
- [Devin](https://spiral.ai/integrations/devin/usaspending-recipient-profile)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/usaspending-recipient-profile)
- [Gemini](https://spiral.ai/integrations/gemini/usaspending-recipient-profile)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/usaspending-recipient-profile)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/usaspending-recipient-profile)
- [goose](https://spiral.ai/integrations/goose/usaspending-recipient-profile)
- [Grok](https://spiral.ai/integrations/grok/usaspending-recipient-profile)
- [Grok Build](https://spiral.ai/integrations/grok-build/usaspending-recipient-profile)
- [Hermes](https://spiral.ai/integrations/hermes/usaspending-recipient-profile)
- [Instinct](https://spiral.ai/integrations/instinct/usaspending-recipient-profile)
- [Manus](https://spiral.ai/integrations/manus/usaspending-recipient-profile)
- [Muse](https://spiral.ai/integrations/muse/usaspending-recipient-profile)
- [Muse Code](https://spiral.ai/integrations/muse-code/usaspending-recipient-profile)
- [n8n](https://spiral.ai/integrations/n8n/usaspending-recipient-profile)
- [Notion](https://spiral.ai/integrations/notion/usaspending-recipient-profile)
- [OpenClaw](https://spiral.ai/integrations/openclaw/usaspending-recipient-profile)
- [opencode](https://spiral.ai/integrations/opencode/usaspending-recipient-profile)
- [Perplexity](https://spiral.ai/integrations/perplexity/usaspending-recipient-profile)
- [Raycast](https://spiral.ai/integrations/raycast/usaspending-recipient-profile)
- [VS Code](https://spiral.ai/integrations/vscode/usaspending-recipient-profile)
- [Windsurf](https://spiral.ai/integrations/windsurf/usaspending-recipient-profile)
- [Zapier](https://spiral.ai/integrations/zapier/usaspending-recipient-profile)

## More dots guides

- [USAspending contract vehicle awards](https://spiral.ai/integrations/dots/usaspending-contract-vehicle-awards)
- [USAspending subawards](https://spiral.ai/integrations/dots/usaspending-subawards)
- [USAspending award transactions](https://spiral.ai/integrations/dots/usaspending-award-transactions)
- [USPTO patent and trademark assignments](https://spiral.ai/integrations/dots/uspto-patent-and-trademark-assignments)
- [USAspending award search](https://spiral.ai/integrations/dots/usaspending-award-search)
- [USPTO patent document](https://spiral.ai/integrations/dots/uspto-patent-document)

## Questions about USAspending recipient profile in dots

**Can dots use USAspending recipient profile?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run USAspending recipient profile like any built-in tool.

**How much does USAspending recipient profile cost in dots?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need an Alexandria account to use USAspending recipient profile in dots?**

You need no Alexandria account. dots uses one Spiral API key for every tool, and Spiral runs USAspending recipient profile on its own Alexandria account.

**How long does it take to set up USAspending recipient profile in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while USAspending recipient profile runs?**

USAspending recipient profile runs in the background. dots starts the run, checks on it and gives you the json when it's ready.

**Does a recipient profile return individual awards?**

It returns one recipient overview with aggregate transaction amounts and counts, plus identity, parent, business type, and location details. It does not return an itemized award list.

**What period do recipient totals cover?**

USAspending supports totals for a specified fiscal year or the latest 12 months. Compare the same period across organizations before ranking their federal funding.

**Why can the same company have different recipient totals?**

USAspending distinguishes parent recipients, child recipients, and recipients that are neither. Check the returned level before comparing records with the same company name.

**How often does USAspending update?**

The data update daily after the nightly pipeline runs. Each source system has its own reporting schedule, so an update can arrive after the underlying award activity.

**Why might recent defense contracting activity be missing?**

Department of Defense and U.S. Army Corps of Engineers procurement data have a 90-day publication delay in FPDS. That delay also affects their availability on USAspending.

