SEC_Market MCP (AI Agent + Company US)

Access SEC EDGAR-backed US company data, filings, metrics, ads, commerce tools, and research via a unified MCP API with audit-traceable lineage.

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

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

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

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}}'