iposignal-microtransactions

# IPOSignal — MCP server, A2A agent card, x402 API

Machine-readable IPO intelligence from [iposignal.xyz](https://iposignal.xyz): deal terms, SEC
filings, AI research, proprietary market and social sentiment, and live valuation metrics for any
US-listed company.

Three ways in, all against the same data:

| Surface | Endpoint | Auth | Cost |
|---|---|---|---|
| **MCP** | `https://iposignal.xyz/api/mcp` | none | free |
| **A2A** | `https://iposignal.xyz/.well-known/agent-card.json` | none | discovery free, calls priced below |
| **HTTP + x402** | `https://iposignal.xyz/api/agent/*` | none | pay-per-request in USDC on Base |

No accounts, no API keys, no rate-limit tiers. This repo holds the public metadata, connection
docs and examples — the product source is private.

---

## MCP server

Streamable HTTP. Free and ungated: the MCP surface mirrors the paid HTTP endpoints at no cost.

```bash
claude mcp add --transport http iposignal https://iposignal.xyz/api/mcp
```

Or in a client config:

```json
{
  "mcpServers": {
    "iposignal": {
      "type": "streamable-http",
      "url": "https://iposignal.xyz/api/mcp"
    }
  }
}
```

### Tools (4)

| Tool | Returns |
|---|---|
| `get_ipo_snapshot` | Full IPO company profile — deal terms, pricing range, expected market cap, SEC registration and prospectus details, offering structure, lifecycle timeline, IBKR indicative borrow fee. Includes AI research with valuation models, competitor benchmarking, underwriter ratings, board analysis and risk factors where available. One of `companyId`, `symbol` or `cik`. |
| `get_ipo_sentiment` | Proprietary daily IPO-market sentiment score, −100 (extreme bearish) to +100 (extreme bullish), with trend over the last N days. Identifies favourable IPO windows and overall appetite for new listings. |
| `get_company_metrics` | Live valuation metrics for any US-listed company, not just IPOs: SEC XBRL companyfacts TTM fundamentals plus latest close → P/E, P/S, EV/Revenue, EV/EBITDA, PEG, linear yields, net-debt/EBITDA, margins, YoY growth. One of `symbol` or `companyName`. |
| `get_ipo_social_sentiment` | Aggregate X/Twitter sentiment for a specific IPO, −1 to +1, with label, post tallies and a one-line summary. Aggregate signal only, not the underlying posts. |

Test it live in the [Glama MCP inspector](https://glama.ai/mcp/inspector) by pasting the endpoint
URL.

---

## A2A agent card

Served at both paths during the spec transition:

- `https://iposignal.xyz/.well-known/agent-card.json` — current spec
- `https://iposignal.xyz/.well-known/agent.json` — legacy (v0.2 and earlier)

Discovery manifest: `https://iposignal.xyz/api/a2a`

Six skills, one free (`lookup_companies_with_financials`), five paid via x402.

---

## Paying with x402

Endpoints under `/api/agent/*` are machine-payable using the open
[x402](https://docs.x402.org/core-concepts/http-402) protocol. USDC on Base mainnet
(`eip155:8453`).

1. Call the endpoint. Unpaid requests return **HTTP 402** with a `PAYMENT-REQUIRED` header
   describing price, asset, network and recipient.
2. Your x402 client signs the payment and retries with a `PAYMENT-SIGNATURE` header.
3. The payment is verified **and settled on-chain**, then the data returns with a
   `PAYMENT-RESPONSE` settlement header.

### Prices

Live values are always in the agent card under `payment.prices` — read them there rather than
hardcoding.

| Endpoint | Price |
|---|---|
| `GET /api/agent/companies?q={query}` | free |
| `GET /api/agent/ipo/by-symbol/{symbol}` | $0.01 |
| `GET /api/agent/financials/by-symbol/{symbol}` | $0.01 |
| `GET /api/agent/company-metrics?symbol={symbol}` | $0.02 |
| `GET /api/agent/ipo-sentiment` | $0.01 |
| `GET /api/agent/social-sentiment?symbol={symbol}` | $0.01 |

See [`examples/`](./examples) for a runnable paid call and an MCP call.

---

## Links

- Product: <https://iposignal.xyz>
- Agent docs: <https://iposignal.xyz/agents>
- MCP registry manifest: [`server.json`](./server.json)
- Contact: iposignal@gmail.com