SEC_Market MCP (AI Agent + Company US)

SKILL.md

# SEC_Market MCP Capabilities

Publish-ready skill describing SEC_Market's full MCP endpoint capabilities for agent discovery directories (including ClawHub).

---

# SEC_Market API

**Base URL:** https://market-royal-city.vercel.app/api/

MCP endpoint: `POST https://market-royal-city.vercel.app/api/mcp`  
MCP discovery: `GET https://market-royal-city.vercel.app/.well-known/mcp.json`  
Agent entrypoint: `GET https://market-royal-city.vercel.app/.well-known/agent.json`  
Catalog: `GET https://market-royal-city.vercel.app/.well-known/agent-products.json`

---

## What This Skill Covers

This skill advertises the full SEC_Market MCP surface area for AI agents:

- Commerce tools (product listing, purchase flow, donation, verification, delivery)
- Ad capabilities (inventory discovery, campaign creation, campaign performance, campaign lookup)
- Company US research (filings, filing document lookup, metrics with lineage, company summary, single-call research bundle)

---

## MCP Tools (Current)

- `list_products`
- `purchase`
- `donate`
- `verify_payment`
- `get_ad_discount`
- `deliver`
- `promote_products`
- `discover_ad_inventory`
- `create_ad_campaign`
- `check_ad_performance`
- `lookup_ad_campaign`
- `list_filings`
- `get_filing`
- `get_metrics`
- `get_company_summary`
- `research_company`

---

## Agent Notes

- Payments and deliveries are supported for both human redirect flows and machine-driven usage.
- Company US data is SEC EDGAR-backed with source lineage fields for auditability.
- Related paid HTTP research bundle route: `GET /api/company/us/research-bundle`.

---

## Example MCP Calls

### List tools/products

```bash
curl -X POST https://market-royal-city.vercel.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"tool":"list_products","params":{}}'
```

### Get metrics with lineage

```bash
curl -X POST https://market-royal-city.vercel.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_metrics","params":{"ticker":"AAPL","period":"latest"}}'
```

### Single-call research bundle

```bash
curl -X POST https://market-royal-city.vercel.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"tool":"research_company","params":{"ticker":"AAPL","filings_limit":15}}'
```