# Caelara Labs: full API reference > 10 suites, 100 endpoints. Base URL pattern: https://.caelaralabs.com. Suites: api, social, agent, compliance, ecom, seo, docs, crypto, geo, media. X: https://x.com/CaelaraLabs ## Authentication and pricing Every /v1/* route accepts any one of three rails, checked in this order: 1. RapidAPI: requests arriving through the RapidAPI gateway carry X-RapidAPI-Proxy-Secret; subscribe on the RapidAPI listing, do not set this header yourself. 2. Direct key: send `X-Caelara-Key: `. Keys are issued by email (ops@caelaralabs.com). 3. x402: with no credentials the route returns HTTP 402 and header `X-Payment-Required: x402`. The JSON body is `{ "x402Version": 1, "error": "...", "accepts": [ ... ] }` where accepts[0] holds scheme "exact", network "base", maxAmountRequired (USDC atomic units, 6 decimals), payTo, and asset. Sign the payment, then retry the same request with the `X-PAYMENT` header (base64 payment payload). | Tier | Price per call (USDC) | Atomic units | Count | |---|---|---|---| | composite | 0.025 | 25000 | 20 | | atomic | 0.005 | 5000 | 80 | - Network: Base (mainnet). Asset: USDC, contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. payTo: 0x085910dA18A735BAc73b8dDb58A06a99A510ebC6. - Unpaid or failed-verification requests are never served; payment settles only after a successful response. ## Response format Successful responses are JSON objects (HTTP 200). The per-endpoint field set is not declared as a fixed schema in the OpenAPI document (responses are `type: object`, additionalProperties allowed), so treat output as a JSON object and read fields defensively. When an upstream source is unavailable the API still returns HTTP 200 with `"partial": true` and best-effort data instead of a server error. Authentication failures return 402 as described above. ## MCP Each suite is a remote Streamable HTTP MCP server at https://.caelaralabs.com/mcp (JSON-RPC 2.0: initialize, tools/list, tools/call). Registry IDs: com.caelaralabs/api, com.caelaralabs/social, com.caelaralabs/agent, com.caelaralabs/compliance, com.caelaralabs/ecom, com.caelaralabs/seo, com.caelaralabs/docs, com.caelaralabs/crypto, com.caelaralabs/geo, com.caelaralabs/media. initialize and tools/list work without credentials. tools/call requires an API key (X-Caelara-Key header) or the RapidAPI key flow; keyless x402 payment applies to the direct HTTP /v1/* routes, not to MCP tool calls. Example tools/call: ```bash curl -X POST https://api.caelaralabs.com/mcp -H "content-type: application/json" -H "X-Caelara-Key: $CAELARA_KEY" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"url_to_markdown","arguments":{"url":"https://example.com"}}}' ``` ## A2A Each suite is also an Agent2Agent (A2A) agent: JSON-RPC 2.0 over HTTP at POST https://.caelaralabs.com/a2a. Methods: message/send and tasks/send (v0.3-style) and SendMessage (v1.0). Agent Cards: https://.caelaralabs.com/.well-known/agent.json and /.well-known/agent-card.json; the index of all 10 suites is https://caelaralabs.com/.well-known/agent.json. Each of a suite's endpoints is a skill; its id is the MCP tool name. Invoke a skill with a data part: {"skill":"url_to_markdown","arguments":{"url":"https://example.com"}}. The call re-enters the same toll gate as /v1/*: with no credentials the response is HTTP 402 carrying the x402 terms (a JSON-RPC error plus x402Version and accepts), so retry with an X-PAYMENT header, or send an X-Caelara-Key header, or use RapidAPI. A paid call returns a Task whose artifact holds the endpoint's JSON. No task state is kept, so tasks/get answers task-not-found. ```bash curl -X POST https://api.caelaralabs.com/a2a -H "content-type: application/json" -H "X-Caelara-Key: $CAELARA_KEY" \ -d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{"message":{"role":"user","messageId":"m1","parts":[{"kind":"data","data":{"skill":"url_to_markdown","arguments":{"url":"https://example.com"}}}]}}}' ``` # Suite: Web Intelligence (api) Company intel, lead verification, URL-to-markdown, SEO X-ray, MX forensics and sitemap crawling. - Host: https://api.caelaralabs.com - OpenAPI: https://api.caelaralabs.com/openapi.json - x402 manifest: https://api.caelaralabs.com/x402-manifest.json - MCP: https://api.caelaralabs.com/mcp (com.caelaralabs/api) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-web-intelligence - 10 endpoints ## GET /v1/company-intel-composite Company intelligence: web metadata + DNS + MX in one call - Tier: composite ($0.025 USDC per call) - MCP tool: company_intel_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | domain | query | string | yes | Company domain, e.g. example.com | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://api.caelaralabs.com/v1/company-intel-composite?domain=example.com" ``` MCP (tools/call arguments): `{"name":"company_intel_composite","arguments":{"domain":"example.com"}}` ## GET /v1/lead-verify-composite Lead verification: email deliverability signals + LinkedIn URL checks - Tier: composite ($0.025 USDC per call) - MCP tool: lead_verify_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | email | query | string | yes | Lead email address | | linkedin_url | query | string | no | LinkedIn profile URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://api.caelaralabs.com/v1/lead-verify-composite?email=user%40example.com" ``` MCP (tools/call arguments): `{"name":"lead_verify_composite","arguments":{"email":"user@example.com"}}` ## GET /v1/url-to-markdown Convert a web page to clean Markdown - Tier: atomic ($0.005 USDC per call) - MCP tool: url_to_markdown Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Page URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://api.caelaralabs.com/v1/url-to-markdown?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"url_to_markdown","arguments":{"url":"https://example.com"}}` ## GET /v1/seo-xray On-page SEO audit of a URL - Tier: atomic ($0.005 USDC per call) - MCP tool: seo_xray Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Page URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://api.caelaralabs.com/v1/seo-xray?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"seo_xray","arguments":{"url":"https://example.com"}}` ## GET /v1/email-mx-forensics MX / provider forensics for an email address - Tier: atomic ($0.005 USDC per call) - MCP tool: email_mx_forensics Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | email | query | string | yes | Email address | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://api.caelaralabs.com/v1/email-mx-forensics?email=user%40example.com" ``` MCP (tools/call arguments): `{"name":"email_mx_forensics","arguments":{"email":"user@example.com"}}` ## GET /v1/social-card-extractor Extract OpenGraph / Twitter card metadata - Tier: atomic ($0.005 USDC per call) - MCP tool: social_card_extractor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Page URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://api.caelaralabs.com/v1/social-card-extractor?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"social_card_extractor","arguments":{"url":"https://example.com"}}` ## GET /v1/sitemap-crawler Parse a sitemap into a URL list - Tier: atomic ($0.005 USDC per call) - MCP tool: sitemap_crawler Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Sitemap or site URL | | limit | query | integer | no | Max URLs (default 100) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://api.caelaralabs.com/v1/sitemap-crawler?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"sitemap_crawler","arguments":{"url":"https://example.com"}}` ## GET /v1/html-table-parser Parse HTML tables into JSON - Tier: atomic ($0.005 USDC per call) - MCP tool: html_table_parser Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | no | Page URL | | html | query | string | no | Raw HTML (alternative to url) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://api.caelaralabs.com/v1/html-table-parser" ``` MCP (tools/call arguments): `{"name":"html_table_parser","arguments":{}}` ## GET /v1/rss-json-normalizer Normalize RSS/Atom feeds to JSON - Tier: atomic ($0.005 USDC per call) - MCP tool: rss_json_normalizer Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Feed URL | | limit | query | integer | no | Max items (default 50) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://api.caelaralabs.com/v1/rss-json-normalizer?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"rss_json_normalizer","arguments":{"url":"https://example.com"}}` ## POST /v1/prompt-firewall-structurer Scan a prompt for injection/PII and return a structured form - Tier: atomic ($0.005 USDC per call) - MCP tool: prompt_firewall_structurer Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | prompt | body | string | yes | Prompt text | | context | body | string | no | Additional context | | strict | body | boolean | no | Strict mode | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"prompt":"example"}' "https://api.caelaralabs.com/v1/prompt-firewall-structurer" ``` MCP (tools/call arguments): `{"name":"prompt_firewall_structurer","arguments":{"prompt":"example"}}` # Suite: Social Analytics (social) Viral video audits, creator profiles, TikTok and YouTube metadata, hook scoring and engagement math. - Host: https://social.caelaralabs.com - OpenAPI: https://social.caelaralabs.com/openapi.json - x402 manifest: https://social.caelaralabs.com/x402-manifest.json - MCP: https://social.caelaralabs.com/mcp (com.caelaralabs/social) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-social-analytics - 10 endpoints ## GET /v1/video-viral-audit-composite Viral audit of a TikTok/YouTube video: metadata + hook score + hashtags + thumbnail - Tier: composite ($0.025 USDC per call) - MCP tool: video_viral_audit_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | TikTok or YouTube video URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://social.caelaralabs.com/v1/video-viral-audit-composite?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"video_viral_audit_composite","arguments":{"url":"https://example.com"}}` ## GET /v1/creator-profile-composite Creator profile audit: bio-link page audit + engagement benchmark - Tier: composite ($0.025 USDC per call) - MCP tool: creator_profile_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Link-in-bio or profile page URL | | followers | query | integer | no | Follower count | | avg_likes | query | integer | no | Average likes per post | | avg_comments | query | integer | no | Average comments per post | | avg_views | query | integer | no | Average views per post | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://social.caelaralabs.com/v1/creator-profile-composite?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"creator_profile_composite","arguments":{"url":"https://example.com"}}` ## GET /v1/tiktok-oembed TikTok video metadata via public oEmbed - Tier: atomic ($0.005 USDC per call) - MCP tool: tiktok_oembed Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | TikTok video URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://social.caelaralabs.com/v1/tiktok-oembed?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"tiktok_oembed","arguments":{"url":"https://example.com"}}` ## GET /v1/youtube-metadata YouTube video metadata via public oEmbed + thumbnail URLs - Tier: atomic ($0.005 USDC per call) - MCP tool: youtube_metadata Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | YouTube video URL or id | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://social.caelaralabs.com/v1/youtube-metadata?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"youtube_metadata","arguments":{"url":"https://example.com"}}` ## POST /v1/reels-hook-scorer Score the opening hook of a Reel/Short/TikTok script or caption - Tier: atomic ($0.005 USDC per call) - MCP tool: reels_hook_scorer Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Script or caption (first lines matter most) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://social.caelaralabs.com/v1/reels-hook-scorer" ``` MCP (tools/call arguments): `{"name":"reels_hook_scorer","arguments":{"text":"example"}}` ## GET /v1/thumbnail-analyzer Analyze a thumbnail image: format, dimensions, aspect ratio, size - Tier: atomic ($0.005 USDC per call) - MCP tool: thumbnail_analyzer Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Image URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://social.caelaralabs.com/v1/thumbnail-analyzer?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"thumbnail_analyzer","arguments":{"url":"https://example.com"}}` ## POST /v1/caption-hashtag-extractor Extract hashtags, mentions, links and emoji from a caption - Tier: atomic ($0.005 USDC per call) - MCP tool: caption_hashtag_extractor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | caption | body | string | yes | Post caption | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"caption":"example"}' "https://social.caelaralabs.com/v1/caption-hashtag-extractor" ``` MCP (tools/call arguments): `{"name":"caption_hashtag_extractor","arguments":{"caption":"example"}}` ## GET /v1/bio-link-auditor Audit a link-in-bio page: link count, platforms, CTA and tracking - Tier: atomic ($0.005 USDC per call) - MCP tool: bio_link_auditor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Bio link page URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://social.caelaralabs.com/v1/bio-link-auditor?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"bio_link_auditor","arguments":{"url":"https://example.com"}}` ## POST /v1/transcript-cleaner Clean a raw transcript/VTT/SRT: timestamps, fillers, duplicates - Tier: atomic ($0.005 USDC per call) - MCP tool: transcript_cleaner Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | transcript | body | string | yes | Raw transcript text | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"transcript":"example"}' "https://social.caelaralabs.com/v1/transcript-cleaner" ``` MCP (tools/call arguments): `{"name":"transcript_cleaner","arguments":{"transcript":"example"}}` ## GET /v1/engagement-rate-calc Compute engagement rate metrics and benchmark tier - Tier: atomic ($0.005 USDC per call) - MCP tool: engagement_rate_calc Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | followers | query | integer | yes | Follower count | | likes | query | integer | yes | Likes | | comments | query | integer | no | Comments | | shares | query | integer | no | Shares | | saves | query | integer | no | Saves | | views | query | integer | no | Views | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://social.caelaralabs.com/v1/engagement-rate-calc?followers=1&likes=1" ``` MCP (tools/call arguments): `{"name":"engagement_rate_calc","arguments":{"followers":"1","likes":"1"}}` # Suite: Agent Safety (agent) Input firewall, output validator, PII redaction, prompt-injection scanning, JSON repair and schema enforcement. - Host: https://agent.caelaralabs.com - OpenAPI: https://agent.caelaralabs.com/openapi.json - x402 manifest: https://agent.caelaralabs.com/x402-manifest.json - MCP: https://agent.caelaralabs.com/mcp (com.caelaralabs/agent) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-agent-safety - 10 endpoints ## POST /v1/agent-input-firewall Scan untrusted input: injection risk + PII redaction + sanitized text + allow/review/block verdict - Tier: composite ($0.025 USDC per call) - MCP tool: agent_input_firewall Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Untrusted input text | | redact_pii | body | boolean | no | Redact PII in sanitized output (default true) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://agent.caelaralabs.com/v1/agent-input-firewall" ``` MCP (tools/call arguments): `{"name":"agent_input_firewall","arguments":{"text":"example"}}` ## POST /v1/agent-output-validator Validate LLM output: repair JSON, enforce schema, check grounding against a source, extract citations - Tier: composite ($0.025 USDC per call) - MCP tool: agent_output_validator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | output | body | string | yes | Raw LLM output | | schema | body | object | no | JSON Schema subset to enforce | | source | body | string | no | Source text for grounding check | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"output":"example"}' "https://agent.caelaralabs.com/v1/agent-output-validator" ``` MCP (tools/call arguments): `{"name":"agent_output_validator","arguments":{"output":"example"}}` ## POST /v1/pii-redactor Redact emails, phones, SSNs, cards (Luhn), IPs, API keys and JWTs - Tier: atomic ($0.005 USDC per call) - MCP tool: pii_redactor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Text to redact | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://agent.caelaralabs.com/v1/pii-redactor" ``` MCP (tools/call arguments): `{"name":"pii_redactor","arguments":{"text":"example"}}` ## POST /v1/prompt-injection-scanner Score text for prompt-injection patterns - Tier: atomic ($0.005 USDC per call) - MCP tool: prompt_injection_scanner Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Text to scan | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://agent.caelaralabs.com/v1/prompt-injection-scanner" ``` MCP (tools/call arguments): `{"name":"prompt_injection_scanner","arguments":{"text":"example"}}` ## POST /v1/token-compressor Compress text to a target ratio of its original length - Tier: atomic ($0.005 USDC per call) - MCP tool: token_compressor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Text to compress | | ratio | body | number | no | Target ratio 0.1-0.9 (default 0.5) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://agent.caelaralabs.com/v1/token-compressor" ``` MCP (tools/call arguments): `{"name":"token_compressor","arguments":{"text":"example"}}` ## POST /v1/json-auto-repair Repair malformed JSON from LLM output - Tier: atomic ($0.005 USDC per call) - MCP tool: json_auto_repair Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Malformed JSON text | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://agent.caelaralabs.com/v1/json-auto-repair" ``` MCP (tools/call arguments): `{"name":"json_auto_repair","arguments":{"text":"example"}}` ## POST /v1/schema-enforcer Validate and coerce data to a JSON Schema - Tier: atomic ($0.005 USDC per call) - MCP tool: schema_enforcer Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | data | body | object | yes | Data to enforce | | schema | body | object | yes | JSON Schema subset | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"data":"example","schema":"example"}' "https://agent.caelaralabs.com/v1/schema-enforcer" ``` MCP (tools/call arguments): `{"name":"schema_enforcer","arguments":{"data":"example","schema":"example"}}` ## POST /v1/hallucination-diff Flag answer sentences unsupported by the source text - Tier: atomic ($0.005 USDC per call) - MCP tool: hallucination_diff Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | source | body | string | yes | Source / ground-truth text | | answer | body | string | yes | Model answer to check | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"source":"example","answer":"example"}' "https://agent.caelaralabs.com/v1/hallucination-diff" ``` MCP (tools/call arguments): `{"name":"hallucination_diff","arguments":{"source":"example","answer":"example"}}` ## POST /v1/citation-extractor Extract URLs, DOIs, arXiv ids and author-year citations - Tier: atomic ($0.005 USDC per call) - MCP tool: citation_extractor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Text containing citations | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://agent.caelaralabs.com/v1/citation-extractor" ``` MCP (tools/call arguments): `{"name":"citation_extractor","arguments":{"text":"example"}}` ## POST /v1/context-chunker Split text into token-bounded overlapping chunks - Tier: atomic ($0.005 USDC per call) - MCP tool: context_chunker Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Text to chunk | | max_tokens | body | integer | no | Max tokens per chunk (default 500) | | overlap | body | integer | no | Overlap tokens (default 50) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://agent.caelaralabs.com/v1/context-chunker" ``` MCP (tools/call arguments): `{"name":"context_chunker","arguments":{"text":"example"}}` # Suite: Compliance & Trust (compliance) Domain trust, entity KYB, SPF/DMARC grading, IBAN/VAT validation, sanctions screening and security-header audits. - Host: https://compliance.caelaralabs.com - OpenAPI: https://compliance.caelaralabs.com/openapi.json - x402 manifest: https://compliance.caelaralabs.com/x402-manifest.json - MCP: https://compliance.caelaralabs.com/mcp (com.caelaralabs/compliance) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-compliance-trust - 10 endpoints ## GET /v1/domain-trust-composite Domain trust report: SPF/DMARC grade + security headers + certificate history + overall trust score - Tier: composite ($0.025 USDC per call) - MCP tool: domain_trust_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | domain | query | string | yes | Domain name, e.g. example.com | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://compliance.caelaralabs.com/v1/domain-trust-composite?domain=example.com" ``` MCP (tools/call arguments): `{"name":"domain_trust_composite","arguments":{"domain":"example.com"}}` ## POST /v1/entity-kyb-composite Entity KYB screen: sanctions fuzzy match + VAT/EIN + IBAN/BIC + email disposable check with risk verdict - Tier: composite ($0.025 USDC per call) - MCP tool: entity_kyb_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | name | body | string | yes | Legal entity name | | vat | body | string | no | VAT number incl. country prefix, or US EIN | | iban | body | string | no | IBAN | | bic | body | string | no | BIC/SWIFT code | | email | body | string | no | Contact email | | watchlist | body | array | no | Optional extra names to screen against | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"name":"example"}' "https://compliance.caelaralabs.com/v1/entity-kyb-composite" ``` MCP (tools/call arguments): `{"name":"entity_kyb_composite","arguments":{"name":"example"}}` ## GET /v1/spf-dmarc-grader Grade SPF and DMARC DNS records (A-F) - Tier: atomic ($0.005 USDC per call) - MCP tool: spf_dmarc_grader Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | domain | query | string | yes | Domain name | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://compliance.caelaralabs.com/v1/spf-dmarc-grader?domain=example.com" ``` MCP (tools/call arguments): `{"name":"spf_dmarc_grader","arguments":{"domain":"example.com"}}` ## GET /v1/ssl-cert-inspector Inspect certificate issuance history via Certificate Transparency - Tier: atomic ($0.005 USDC per call) - MCP tool: ssl_cert_inspector Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | domain | query | string | yes | Domain name | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://compliance.caelaralabs.com/v1/ssl-cert-inspector?domain=example.com" ``` MCP (tools/call arguments): `{"name":"ssl_cert_inspector","arguments":{"domain":"example.com"}}` ## GET /v1/ip-asn-reputation ASN lookup and reserved/private range classification for an IP - Tier: atomic ($0.005 USDC per call) - MCP tool: ip_asn_reputation Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | ip | query | string | yes | IPv4 or IPv6 address | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://compliance.caelaralabs.com/v1/ip-asn-reputation?ip=example" ``` MCP (tools/call arguments): `{"name":"ip_asn_reputation","arguments":{"ip":"example"}}` ## GET /v1/disposable-email-db Detect disposable / throwaway email domains and role accounts - Tier: atomic ($0.005 USDC per call) - MCP tool: disposable_email_db Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | email | query | string | yes | Email address or domain | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://compliance.caelaralabs.com/v1/disposable-email-db?email=user%40example.com" ``` MCP (tools/call arguments): `{"name":"disposable_email_db","arguments":{"email":"user@example.com"}}` ## GET /v1/iban-bic-validator Validate IBAN (mod-97, country length) and BIC/SWIFT format - Tier: atomic ($0.005 USDC per call) - MCP tool: iban_bic_validator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | iban | query | string | no | IBAN | | bic | query | string | no | BIC/SWIFT code | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://compliance.caelaralabs.com/v1/iban-bic-validator" ``` MCP (tools/call arguments): `{"name":"iban_bic_validator","arguments":{}}` ## GET /v1/vat-ein-checkdigit Validate EU VAT number check digits and US EIN format - Tier: atomic ($0.005 USDC per call) - MCP tool: vat_ein_checkdigit Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | number | query | string | yes | VAT number with country prefix, or US EIN (NN-NNNNNNN) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://compliance.caelaralabs.com/v1/vat-ein-checkdigit?number=example" ``` MCP (tools/call arguments): `{"name":"vat_ein_checkdigit","arguments":{"number":"example"}}` ## POST /v1/sanctions-fuzzy-screen Fuzzy-match a name against a built-in seed list plus a caller-supplied watchlist - Tier: atomic ($0.005 USDC per call) - MCP tool: sanctions_fuzzy_screen Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | name | body | string | yes | Name to screen | | watchlist | body | array | no | Extra names to screen against | | threshold | body | number | no | Match threshold 0.5-1 (default 0.85) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"name":"example"}' "https://compliance.caelaralabs.com/v1/sanctions-fuzzy-screen" ``` MCP (tools/call arguments): `{"name":"sanctions_fuzzy_screen","arguments":{"name":"example"}}` ## GET /v1/security-headers-audit Fetch a URL and grade its HTTP security headers - Tier: atomic ($0.005 USDC per call) - MCP tool: security_headers_audit Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | URL or hostname to audit | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://compliance.caelaralabs.com/v1/security-headers-audit?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"security_headers_audit","arguments":{"url":"https://example.com"}}` # Suite: E-Commerce Intelligence (ecom) Product and storefront X-ray, JSON-LD parsing, GTIN validation, price-drop tracking and margin math. - Host: https://ecom.caelaralabs.com - OpenAPI: https://ecom.caelaralabs.com/openapi.json - x402 manifest: https://ecom.caelaralabs.com/x402-manifest.json - MCP: https://ecom.caelaralabs.com/mcp (com.caelaralabs/ecom) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-e-commerce-intelligence - 10 endpoints ## GET /v1/product-intel-composite Product page intelligence: JSON-LD product, GTIN validation, SKU normalization, review sentiment, ad pixels and price signals - Tier: composite ($0.025 USDC per call) - MCP tool: product_intel_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Product page URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://ecom.caelaralabs.com/v1/product-intel-composite?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"product_intel_composite","arguments":{"url":"https://example.com"}}` ## GET /v1/storefront-xray-composite Storefront X-ray: platform, ad/analytics stack, payment options, structured data and Shopify catalog sample - Tier: composite ($0.025 USDC per call) - MCP tool: storefront_xray_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Storefront URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://ecom.caelaralabs.com/v1/storefront-xray-composite?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"storefront_xray_composite","arguments":{"url":"https://example.com"}}` ## POST /v1/jsonld-product-parser Extract schema.org Product data (offers, ratings, reviews) from a page - Tier: atomic ($0.005 USDC per call) - MCP tool: jsonld_product_parser Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | body | string | no | Page URL (or supply html) | | html | body | string | no | Raw HTML (or supply url) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{}' "https://ecom.caelaralabs.com/v1/jsonld-product-parser" ``` MCP (tools/call arguments): `{"name":"jsonld_product_parser","arguments":{}}` ## GET /v1/shopify-feed-extractor Extract the public Shopify products.json catalog with pricing and stock summary - Tier: atomic ($0.005 USDC per call) - MCP tool: shopify_feed_extractor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Shopify store URL | | limit | query | integer | no | Products per page 1-250 (default 30) | | page | query | integer | no | Page number (default 1) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://ecom.caelaralabs.com/v1/shopify-feed-extractor?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"shopify_feed_extractor","arguments":{"url":"https://example.com"}}` ## GET /v1/gtin-upc-validator Validate GTIN-8/12/13/14 (UPC/EAN) check digits and convert formats - Tier: atomic ($0.005 USDC per call) - MCP tool: gtin_upc_validator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | code | query | string | yes | Barcode digits | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://ecom.caelaralabs.com/v1/gtin-upc-validator?code=example" ``` MCP (tools/call arguments): `{"name":"gtin_upc_validator","arguments":{"code":"example"}}` ## POST /v1/price-drop-comparator Compare a price series (or old/new price) and flag drops, lows and target hits - Tier: atomic ($0.005 USDC per call) - MCP tool: price_drop_comparator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | prices | body | array | no | Price history, oldest first (numbers or {price,date}) | | old_price | body | number | no | Previous price | | new_price | body | number | no | Current price | | threshold_pct | body | number | no | Drop/increase threshold percent (default 10) | | target_price | body | number | no | Target buy price | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{}' "https://ecom.caelaralabs.com/v1/price-drop-comparator" ``` MCP (tools/call arguments): `{"name":"price_drop_comparator","arguments":{}}` ## POST /v1/ad-pixel-detector Detect ad, analytics and marketing pixels (Meta, TikTok, GA4, GTM, Pinterest, etc.) with tag IDs - Tier: atomic ($0.005 USDC per call) - MCP tool: ad_pixel_detector Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | body | string | no | Page URL (or supply html) | | html | body | string | no | Raw HTML (or supply url) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{}' "https://ecom.caelaralabs.com/v1/ad-pixel-detector" ``` MCP (tools/call arguments): `{"name":"ad_pixel_detector","arguments":{}}` ## GET /v1/currency-margin-calc Margin, markup, breakeven and target price with FX rate, fees, shipping and tax - Tier: atomic ($0.005 USDC per call) - MCP tool: currency_margin_calc Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | cost | query | number | yes | Unit cost | | price | query | number | yes | Selling price | | fx_rate | query | number | no | FX multiplier cost currency to price currency (default 1) | | fee_pct | query | number | no | Marketplace/payment fee percent | | fixed_fee | query | number | no | Fixed fee per order | | shipping_cost | query | number | no | Shipping cost in price currency | | tax_pct | query | number | no | Tax percent included in price | | target_margin_pct | query | number | no | Desired margin percent for suggested price | | cost_currency | query | string | no | Cost currency code | | price_currency | query | string | no | Price currency code | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://ecom.caelaralabs.com/v1/currency-margin-calc?cost=1&price=1" ``` MCP (tools/call arguments): `{"name":"currency_margin_calc","arguments":{"cost":"1","price":"1"}}` ## POST /v1/review-sentiment-parser Score review sentiment with aspect breakdown (quality, price, shipping, fit, service) - Tier: atomic ($0.005 USDC per call) - MCP tool: review_sentiment_parser Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | reviews | body | array | no | Array of review strings or {text, rating} | | text | body | string | no | Newline-separated reviews | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{}' "https://ecom.caelaralabs.com/v1/review-sentiment-parser" ``` MCP (tools/call arguments): `{"name":"review_sentiment_parser","arguments":{}}` ## POST /v1/sku-normalizer Normalize SKUs into canonical, compact and match-key forms - Tier: atomic ($0.005 USDC per call) - MCP tool: sku_normalizer Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | skus | body | array | no | Array of SKU strings | | sku | body | string | no | Single SKU string | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{}' "https://ecom.caelaralabs.com/v1/sku-normalizer" ``` MCP (tools/call arguments): `{"name":"sku_normalizer","arguments":{}}` # Suite: SEO & GEO Readiness (seo) llms.txt and AI-crawler audits, redirect tracing, schema validation, SERP previews and link scanning. - Host: https://seo.caelaralabs.com - OpenAPI: https://seo.caelaralabs.com/openapi.json - x402 manifest: https://seo.caelaralabs.com/x402-manifest.json - MCP: https://seo.caelaralabs.com/mcp (com.caelaralabs/seo) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-seo-geo-readiness - 10 endpoints ## GET /v1/geo-readiness-composite Generative-engine readiness score: llms.txt + AI crawler access + structured data + content clarity - Tier: composite ($0.025 USDC per call) - MCP tool: geo_readiness_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Page URL to assess | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://seo.caelaralabs.com/v1/geo-readiness-composite?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"geo_readiness_composite","arguments":{"url":"https://example.com"}}` ## GET /v1/technical-seo-composite Technical SEO audit: redirects, meta, canonical, headings, hreflang, schema, robots.txt with scored issues - Tier: composite ($0.025 USDC per call) - MCP tool: technical_seo_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Page URL to audit | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://seo.caelaralabs.com/v1/technical-seo-composite?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"technical_seo_composite","arguments":{"url":"https://example.com"}}` ## GET /v1/llms-txt-auditor Fetch and audit /llms.txt (and llms-full.txt) against the llms.txt format - Tier: atomic ($0.005 USDC per call) - MCP tool: llms_txt_auditor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Any URL on the target site | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://seo.caelaralabs.com/v1/llms-txt-auditor?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"llms_txt_auditor","arguments":{"url":"https://example.com"}}` ## GET /v1/ai-bot-robots-check Check whether GPTBot, PerplexityBot, Google-Extended and other AI crawlers are allowed by robots.txt - Tier: atomic ($0.005 USDC per call) - MCP tool: ai_bot_robots_check Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | URL (path is evaluated against robots.txt) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://seo.caelaralabs.com/v1/ai-bot-robots-check?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"ai_bot_robots_check","arguments":{"url":"https://example.com"}}` ## GET /v1/redirect-chain-tracer Trace a redirect chain hop by hop with loop detection and status issues - Tier: atomic ($0.005 USDC per call) - MCP tool: redirect_chain_tracer Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Starting URL | | max_hops | query | integer | no | Max hops 1-10 (default 10) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://seo.caelaralabs.com/v1/redirect-chain-tracer?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"redirect_chain_tracer","arguments":{"url":"https://example.com"}}` ## GET /v1/schema-org-validator Extract and validate JSON-LD / microdata structured data on a page - Tier: atomic ($0.005 USDC per call) - MCP tool: schema_org_validator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Page URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://seo.caelaralabs.com/v1/schema-org-validator?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"schema_org_validator","arguments":{"url":"https://example.com"}}` ## GET /v1/serp-pixel-preview Pixel-width SERP snippet preview with truncation for desktop and mobile - Tier: atomic ($0.005 USDC per call) - MCP tool: serp_pixel_preview Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | title | query | string | yes | Page title | | description | query | string | no | Meta description | | url | query | string | no | Display URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://seo.caelaralabs.com/v1/serp-pixel-preview?title=example" ``` MCP (tools/call arguments): `{"name":"serp_pixel_preview","arguments":{"title":"example"}}` ## POST /v1/keyword-ngrams-extractor Extract top keyword unigrams, bigrams and trigrams with density - Tier: atomic ($0.005 USDC per call) - MCP tool: keyword_ngrams_extractor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Text to analyze | | max_n | body | integer | no | Largest n-gram size 1-3 (default 3) | | top | body | integer | no | Results per n-gram size (default 15) | | include_stopwords | body | boolean | no | Keep stopword-edged phrases | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://seo.caelaralabs.com/v1/keyword-ngrams-extractor" ``` MCP (tools/call arguments): `{"name":"keyword_ngrams_extractor","arguments":{"text":"example"}}` ## GET /v1/hreflang-validator Validate hreflang annotations: codes, x-default, self-reference and optional return links - Tier: atomic ($0.005 USDC per call) - MCP tool: hreflang_validator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Page URL | | check_return_links | query | boolean | no | Verify reciprocal links on up to 5 alternates (true/false) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://seo.caelaralabs.com/v1/hreflang-validator?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"hreflang_validator","arguments":{"url":"https://example.com"}}` ## GET /v1/broken-link-scanner Check outbound and internal links on a page for 4xx/5xx and dead hosts - Tier: atomic ($0.005 USDC per call) - MCP tool: broken_link_scanner Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Page URL | | max_links | query | integer | no | Max links to check 1-40 (default 25) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://seo.caelaralabs.com/v1/broken-link-scanner?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"broken_link_scanner","arguments":{"url":"https://example.com"}}` # Suite: Document Utilities (docs) Invoice-to-JSON, universal data bridge, CSV/XML conversion, safe markdown, address and phone normalization. - Host: https://docs.caelaralabs.com - OpenAPI: https://docs.caelaralabs.com/openapi.json - x402 manifest: https://docs.caelaralabs.com/x402-manifest.json - MCP: https://docs.caelaralabs.com/mcp (com.caelaralabs/docs) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-document-utilities - 10 endpoints ## POST /v1/invoice-json-composite Convert raw invoice text into structured JSON: number, dates, currency, line items, totals and consistency checks - Tier: composite ($0.025 USDC per call) - MCP tool: invoice_json_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Raw invoice text | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://docs.caelaralabs.com/v1/invoice-json-composite" ``` MCP (tools/call arguments): `{"name":"invoice_json_composite","arguments":{"text":"example"}}` ## POST /v1/universal-data-bridge Convert data between CSV, XML and JSON with format auto-detection and type inference - Tier: composite ($0.025 USDC per call) - MCP tool: universal_data_bridge Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | data | body | string | yes | Input document (string) or JSON value | | from | body | string | no | Source format: auto/csv/xml/json (default auto) | | to | body | string | yes | Target format: json/csv/xml | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"data":"example","to":"example"}' "https://docs.caelaralabs.com/v1/universal-data-bridge" ``` MCP (tools/call arguments): `{"name":"universal_data_bridge","arguments":{"data":"example","to":"example"}}` ## POST /v1/csv-to-typed-json Parse CSV into JSON rows with inferred number, boolean, null and date types - Tier: atomic ($0.005 USDC per call) - MCP tool: csv_to_typed_json Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | csv | body | string | yes | CSV text | | delimiter | body | string | no | Delimiter (auto-detected if omitted) | | header | body | boolean | no | First row is header (default true) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"csv":"example"}' "https://docs.caelaralabs.com/v1/csv-to-typed-json" ``` MCP (tools/call arguments): `{"name":"csv_to_typed_json","arguments":{"csv":"example"}}` ## POST /v1/xml-to-json-clean Convert XML to clean JSON (attributes prefixed with @, repeated tags to arrays) - Tier: atomic ($0.005 USDC per call) - MCP tool: xml_to_json_clean Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | xml | body | string | yes | XML text | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"xml":"example"}' "https://docs.caelaralabs.com/v1/xml-to-json-clean" ``` MCP (tools/call arguments): `{"name":"xml_to_json_clean","arguments":{"xml":"example"}}` ## POST /v1/markdown-to-sanitized-html Render markdown to HTML with all raw HTML escaped and unsafe URLs removed - Tier: atomic ($0.005 USDC per call) - MCP tool: markdown_to_sanitized_html Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | markdown | body | string | yes | Markdown text | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"markdown":"example"}' "https://docs.caelaralabs.com/v1/markdown-to-sanitized-html" ``` MCP (tools/call arguments): `{"name":"markdown_to_sanitized_html","arguments":{"markdown":"example"}}` ## POST /v1/html-to-clean-text Strip HTML to readable plain text, dropping scripts, styles and tags - Tier: atomic ($0.005 USDC per call) - MCP tool: html_to_clean_text Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | html | body | string | yes | HTML text | | keep_links | body | boolean | no | Append link URLs in brackets | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"html":"example"}' "https://docs.caelaralabs.com/v1/html-to-clean-text" ``` MCP (tools/call arguments): `{"name":"html_to_clean_text","arguments":{"html":"example"}}` ## POST /v1/regex-entity-extractor Extract emails, URLs, phones, IPs, dates, money, hashtags, mentions and more from text - Tier: atomic ($0.005 USDC per call) - MCP tool: regex_entity_extractor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | body | string | yes | Text to scan | | types | body | array | no | Entity types to extract (array of strings) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"text":"example"}' "https://docs.caelaralabs.com/v1/regex-entity-extractor" ``` MCP (tools/call arguments): `{"name":"regex_entity_extractor","arguments":{"text":"example"}}` ## POST /v1/address-normalizer Normalize a postal address: casing, street/directional abbreviations, unit, ZIP and state - Tier: atomic ($0.005 USDC per call) - MCP tool: address_normalizer Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | address | body | string | yes | Free-form address | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"address":"example"}' "https://docs.caelaralabs.com/v1/address-normalizer" ``` MCP (tools/call arguments): `{"name":"address_normalizer","arguments":{"address":"example"}}` ## POST /v1/phone-e164-formatter Format a phone number to E.164 with country detection and validity check - Tier: atomic ($0.005 USDC per call) - MCP tool: phone_e164_formatter Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | phone | body | string | yes | Phone number | | country | body | string | no | Default ISO-2 country code, e.g. US | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"phone":"example"}' "https://docs.caelaralabs.com/v1/phone-e164-formatter" ``` MCP (tools/call arguments): `{"name":"phone_e164_formatter","arguments":{"phone":"example"}}` ## POST /v1/dedupe-fuzzy-matcher Cluster near-duplicate strings using Jaro-Winkler and token similarity - Tier: atomic ($0.005 USDC per call) - MCP tool: dedupe_fuzzy_matcher Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | items | body | array | yes | Array of strings | | threshold | body | number | no | Similarity threshold 0.5-1 (default 0.88) | cURL: ```bash curl -X POST -H "X-Caelara-Key: $CAELARA_KEY" -H "content-type: application/json" -d '{"items":"example"}' "https://docs.caelaralabs.com/v1/dedupe-fuzzy-matcher" ``` MCP (tools/call arguments): `{"name":"dedupe_fuzzy_matcher","arguments":{"items":"example"}}` # Suite: On-Chain Intelligence (crypto) Token safety scoring, wallet portfolios, Solana mint audits, ERC-20 inspection, DEX depth and gas estimates. - Host: https://crypto.caelaralabs.com - OpenAPI: https://crypto.caelaralabs.com/openapi.json - x402 manifest: https://crypto.caelaralabs.com/x402-manifest.json - MCP: https://crypto.caelaralabs.com/mcp (com.caelaralabs/crypto) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-on-chain-intelligence - 10 endpoints ## GET /v1/token-safety-composite Safety score for an EVM or Solana token: contract/mint authority checks, holder concentration, DEX liquidity depth, pool age and trade-flow flags - Tier: composite ($0.025 USDC per call) - MCP tool: token_safety_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | address | query | string | yes | Token contract (0x...) or Solana mint address | | chain | query | string | no | Chain: base/ethereum/arbitrum/optimism (default base) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/token-safety-composite?address=example" ``` MCP (tools/call arguments): `{"name":"token_safety_composite","arguments":{"address":"example"}}` ## GET /v1/wallet-portfolio-composite USD portfolio for an EVM or Solana wallet: native balance, major token balances, prices and allocation - Tier: composite ($0.025 USDC per call) - MCP tool: wallet_portfolio_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | address | query | string | yes | Wallet address (0x... or Solana) | | chain | query | string | no | Chain: base/ethereum/arbitrum/optimism (EVM, default base). Solana is auto-detected from the address format | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/wallet-portfolio-composite?address=example" ``` MCP (tools/call arguments): `{"name":"wallet_portfolio_composite","arguments":{"address":"example"}}` ## GET /v1/solana-mint-auditor Audit a Solana SPL mint: mint/freeze authority, supply, decimals, Token-2022 extensions and top-holder concentration - Tier: atomic ($0.005 USDC per call) - MCP tool: solana_mint_auditor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | mint | query | string | yes | Solana mint address | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/solana-mint-auditor?mint=example" ``` MCP (tools/call arguments): `{"name":"solana_mint_auditor","arguments":{"mint":"example"}}` ## GET /v1/base-erc20-inspector Inspect an ERC-20 on Base or another EVM chain: name, symbol, decimals, supply, owner, proxy slot and risky function selectors - Tier: atomic ($0.005 USDC per call) - MCP tool: base_erc20_inspector Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | address | query | string | yes | Token contract address | | chain | query | string | no | Chain: base/ethereum/arbitrum/optimism (default base) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/base-erc20-inspector?address=example" ``` MCP (tools/call arguments): `{"name":"base_erc20_inspector","arguments":{"address":"example"}}` ## GET /v1/dex-liquidity-depth DEX pools for a token with liquidity, volume, and estimated price impact for $100 to $100k trades - Tier: atomic ($0.005 USDC per call) - MCP tool: dex_liquidity_depth Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | token | query | string | yes | Token address (EVM or Solana mint) | | chain | query | string | no | DexScreener chain id filter, e.g. base, solana, ethereum | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/dex-liquidity-depth?token=example" ``` MCP (tools/call arguments): `{"name":"dex_liquidity_depth","arguments":{"token":"example"}}` ## GET /v1/stablecoin-depeg-monitor Peg deviation in basis points for major stablecoins from independent exchange feeds - Tier: atomic ($0.005 USDC per call) - MCP tool: stablecoin_depeg_monitor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | symbols | query | string | no | Comma list from USDT,USDC,DAI (default all) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/stablecoin-depeg-monitor" ``` MCP (tools/call arguments): `{"name":"stablecoin_depeg_monitor","arguments":{}}` ## GET /v1/gas-fee-estimator Live gas price and USD cost estimates for transfers, ERC-20 transfers and swaps on EVM chains - Tier: atomic ($0.005 USDC per call) - MCP tool: gas_fee_estimator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | chain | query | string | no | Chain: base/ethereum/arbitrum/optimism (default base) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/gas-fee-estimator" ``` MCP (tools/call arguments): `{"name":"gas_fee_estimator","arguments":{}}` ## GET /v1/tx-hash-decoder Decode an EVM transaction: status, fee, method selector, ERC-20 transfers and approvals - Tier: atomic ($0.005 USDC per call) - MCP tool: tx_hash_decoder Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | hash | query | string | yes | Transaction hash (0x + 64 hex) | | chain | query | string | no | Chain: base/ethereum/arbitrum/optimism (default base) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/tx-hash-decoder?hash=example" ``` MCP (tools/call arguments): `{"name":"tx_hash_decoder","arguments":{"hash":"example"}}` ## GET /v1/address-checksum-validator Validate an EVM address (EIP-55 checksum) or Solana address (base58, 32 bytes) and return the canonical form - Tier: atomic ($0.005 USDC per call) - MCP tool: address_checksum_validator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | address | query | string | yes | Address to validate | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/address-checksum-validator?address=example" ``` MCP (tools/call arguments): `{"name":"address_checksum_validator","arguments":{"address":"example"}}` ## GET /v1/token-price-aggregator Median USD price for a ticker across Coinbase, Kraken and Bitstamp with spread, plus DEX price when a contract address is supplied - Tier: atomic ($0.005 USDC per call) - MCP tool: token_price_aggregator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | symbol | query | string | yes | Ticker, e.g. ETH, BTC, SOL | | address | query | string | no | Optional token contract/mint for DEX pricing | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://crypto.caelaralabs.com/v1/token-price-aggregator?symbol=example" ``` MCP (tools/call arguments): `{"name":"token_price_aggregator","arguments":{"symbol":"example"}}` # Suite: Global Locale (geo) Timezone and scheduling math, public holidays, live FX, VAT/GST rates, postal validation and cross-border checkout. - Host: https://geo.caelaralabs.com - OpenAPI: https://geo.caelaralabs.com/openapi.json - x402 manifest: https://geo.caelaralabs.com/x402-manifest.json - MCP: https://geo.caelaralabs.com/mcp (com.caelaralabs/geo) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-global-locale - 10 endpoints ## GET /v1/global-scheduling-composite Find meeting slots that fall inside working hours for every participant timezone, skipping weekends and public holidays, with per-participant local times - Tier: composite ($0.025 USDC per call) - MCP tool: global_scheduling_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | timezones | query | string | yes | Comma list of IANA timezones; the first is the organizer whose local day anchors the search | | date | query | string | no | Organizer-local date YYYY-MM-DD (default today) | | duration_minutes | query | integer | no | Meeting length in minutes (default 60) | | work_start | query | string | no | Working day start HH:MM (default 09:00) | | work_end | query | string | no | Working day end HH:MM (default 17:00) | | countries | query | string | no | Comma list of ISO alpha-2 codes aligned with timezones, used to skip public holidays | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/global-scheduling-composite?timezones=example" ``` MCP (tools/call arguments): `{"name":"global_scheduling_composite","arguments":{"timezones":"example"}}` ## GET /v1/cross-border-checkout-composite Cross-border checkout quote: FX conversion into the destination currency, VAT/GST, postal-code validation and EU reverse-charge eligibility - Tier: composite ($0.025 USDC per call) - MCP tool: cross_border_checkout_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | amount | query | number | yes | Order subtotal in the source currency | | currency | query | string | yes | Source currency ISO 4217 code, e.g. USD | | country | query | string | yes | Destination country (ISO alpha-2, e.g. DE) | | postal_code | query | string | no | Destination postal code to validate | | prices_include_tax | query | string | no | true when the amount already includes tax | | vat_id | query | string | no | Buyer VAT ID for B2B reverse-charge screening (format only, not VIES-verified) | | origin_country | query | string | no | Seller country (ISO alpha-2) for reverse-charge screening | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/cross-border-checkout-composite?amount=1¤cy=example&country=example" ``` MCP (tools/call arguments): `{"name":"cross_border_checkout_composite","arguments":{"amount":"1","currency":"example","country":"example"}}` ## GET /v1/timezone-converter Convert a date-time between IANA timezones with offsets, abbreviations and DST flags - Tier: atomic ($0.005 USDC per call) - MCP tool: timezone_converter Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | from | query | string | yes | Source IANA timezone, e.g. America/New_York | | to | query | string | yes | Comma list of target IANA timezones | | time | query | string | no | ISO 8601 time; wall time is read in the source timezone (default now) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/timezone-converter?from=example&to=example" ``` MCP (tools/call arguments): `{"name":"timezone_converter","arguments":{"from":"example","to":"example"}}` ## GET /v1/business-hours-calc Is a location open right now (or at a given instant) and when does it next open or close - Tier: atomic ($0.005 USDC per call) - MCP tool: business_hours_calc Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | tz | query | string | yes | IANA timezone of the business | | start | query | string | no | Opening time HH:MM (default 09:00) | | end | query | string | no | Closing time HH:MM (default 17:00) | | days | query | string | no | Comma list of open weekdays, 0=Sunday..6=Saturday (default 1,2,3,4,5) | | at | query | string | no | ISO 8601 instant to evaluate (default now) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/business-hours-calc?tz=example" ``` MCP (tools/call arguments): `{"name":"business_hours_calc","arguments":{"tz":"example"}}` ## GET /v1/public-holiday-lookup Public holidays for a country and year, with an optional is-holiday check for one date - Tier: atomic ($0.005 USDC per call) - MCP tool: public_holiday_lookup Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | country | query | string | yes | ISO alpha-2 country code | | year | query | integer | no | Year (default current) | | date | query | string | no | Optional YYYY-MM-DD to test | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/public-holiday-lookup?country=example" ``` MCP (tools/call arguments): `{"name":"public_holiday_lookup","arguments":{"country":"example"}}` ## GET /v1/live-fx-rates Live foreign-exchange rates for a base currency with optional amount conversion - Tier: atomic ($0.005 USDC per call) - MCP tool: live_fx_rates Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | base | query | string | no | Base currency ISO 4217 (default USD) | | symbols | query | string | no | Comma list of target currencies (default major set) | | amount | query | number | no | Amount of the base currency to convert | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/live-fx-rates" ``` MCP (tools/call arguments): `{"name":"live_fx_rates","arguments":{}}` ## GET /v1/vat-gst-rate-lookup Standard and reduced VAT/GST rates for a country with optional tax amount calculation - Tier: atomic ($0.005 USDC per call) - MCP tool: vat_gst_rate_lookup Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | country | query | string | yes | ISO alpha-2 country code | | amount | query | number | no | Net amount to compute tax on | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/vat-gst-rate-lookup?country=example" ``` MCP (tools/call arguments): `{"name":"vat_gst_rate_lookup","arguments":{"country":"example"}}` ## GET /v1/postal-code-validator Validate and normalize a postal code for a country - Tier: atomic ($0.005 USDC per call) - MCP tool: postal_code_validator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | country | query | string | yes | ISO alpha-2 country code | | code | query | string | yes | Postal code to validate | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/postal-code-validator?country=example&code=example" ``` MCP (tools/call arguments): `{"name":"postal_code_validator","arguments":{"country":"example","code":"example"}}` ## GET /v1/country-iso-enricher Resolve a country name or ISO code to alpha-2/alpha-3/numeric codes, currency, calling code, region, capital and primary timezone - Tier: atomic ($0.005 USDC per call) - MCP tool: country_iso_enricher Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | q | query | string | yes | Country name, alpha-2, alpha-3 or numeric code | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/country-iso-enricher?q=example" ``` MCP (tools/call arguments): `{"name":"country_iso_enricher","arguments":{"q":"example"}}` ## GET /v1/distance-haversine-calc Great-circle distance, initial bearing and midpoint between two coordinates - Tier: atomic ($0.005 USDC per call) - MCP tool: distance_haversine_calc Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | lat1 | query | number | yes | Latitude of point A | | lon1 | query | number | yes | Longitude of point A | | lat2 | query | number | yes | Latitude of point B | | lon2 | query | number | yes | Longitude of point B | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://geo.caelaralabs.com/v1/distance-haversine-calc?lat1=1&lon1=1&lat2=1&lon2=1" ``` MCP (tools/call arguments): `{"name":"distance_haversine_calc","arguments":{"lat1":"1","lon1":"1","lat2":"1","lon2":"1"}}` # Suite: Dynamic Media (media) Open Graph and social cards, QR codes, color palettes, HD favicons, avatars, badges and image inspection. - Host: https://media.caelaralabs.com - OpenAPI: https://media.caelaralabs.com/openapi.json - x402 manifest: https://media.caelaralabs.com/x402-manifest.json - MCP: https://media.caelaralabs.com/mcp (com.caelaralabs/media) - RapidAPI: https://rapidapi.com/caelara-labs-caelara-labs-default/api/caelara-labs-dynamic-media - 10 endpoints ## GET /v1/brand-kit-composite Build a brand kit from a domain: best-resolution icon, extracted palette with accessible text colors, initials avatar and badge assets - Tier: composite ($0.025 USDC per call) - MCP tool: brand_kit_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | domain | query | string | yes | Brand domain, e.g. stripe.com | | name | query | string | no | Brand display name (default derived from the domain) | | color | query | string | no | Brand color override (hex, with or without #) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/brand-kit-composite?domain=example.com" ``` MCP (tools/call arguments): `{"name":"brand_kit_composite","arguments":{"domain":"example.com"}}` ## GET /v1/dynamic-social-card-composite Generate a full social-card set (Open Graph, Twitter, square, story) as SVG with a QR code, meta tags and alt text - Tier: composite ($0.025 USDC per call) - MCP tool: dynamic_social_card_composite Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | title | query | string | yes | Card headline | | subtitle | query | string | no | Supporting line | | brand | query | string | no | Brand label shown on the card | | url | query | string | no | Destination URL; adds a QR code and domain label | | theme | query | string | no | dark (default) or light | | accent | query | string | no | Accent color (hex, with or without #) | | bg | query | string | no | Background color (hex, with or without #) | | fg | query | string | no | Text color (hex, with or without #) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/dynamic-social-card-composite?title=example" ``` MCP (tools/call arguments): `{"name":"dynamic_social_card_composite","arguments":{"title":"example"}}` ## GET /v1/edge-og-svg-generator Render an Open Graph card (default 1200x630) as SVG - Tier: atomic ($0.005 USDC per call) - MCP tool: edge_og_svg_generator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | title | query | string | yes | Headline | | subtitle | query | string | no | Supporting line | | brand | query | string | no | Brand label | | theme | query | string | no | dark (default) or light | | bg | query | string | no | Background color (hex, with or without #) | | fg | query | string | no | Text color (hex, with or without #) | | accent | query | string | no | Accent color (hex, with or without #) | | width | query | integer | no | Width in px (200-4000, default 1200) | | height | query | integer | no | Height in px (200-4000, default 630) | | format | query | string | no | json (default, includes svg + data URI) or svg (raw image/svg+xml) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/edge-og-svg-generator?title=example" ``` MCP (tools/call arguments): `{"name":"edge_og_svg_generator","arguments":{"title":"example"}}` ## GET /v1/qr-code-svg-builder Encode text or a URL as a scannable QR code SVG - Tier: atomic ($0.005 USDC per call) - MCP tool: qr_code_svg_builder Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | text | query | string | yes | Text or URL to encode (max 1000 bytes) | | ecc | query | string | no | Error correction: L, M (default), Q or H | | size | query | integer | no | Rendered size in px (64-2048, default 256) | | margin | query | integer | no | Quiet zone in modules (0-16, default 4) | | fg | query | string | no | Module color (hex, with or without #) | | bg | query | string | no | Background color (hex, with or without #) | | format | query | string | no | json (default, includes svg + data URI) or svg (raw image/svg+xml) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/qr-code-svg-builder?text=example" ``` MCP (tools/call arguments): `{"name":"qr_code_svg_builder","arguments":{"text":"example"}}` ## GET /v1/color-palette-extractor Extract a dominant-color palette from a PNG or SVG image, or normalize a list of colors, with contrast ratios - Tier: atomic ($0.005 USDC per call) - MCP tool: color_palette_extractor Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | no | Image URL (PNG or SVG are pixel/markup sampled) | | colors | query | string | no | Comma list of hex colors to analyze instead of an image | | count | query | integer | no | Number of colors (1-12, default 5) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/color-palette-extractor" ``` MCP (tools/call arguments): `{"name":"color_palette_extractor","arguments":{}}` ## GET /v1/favicon-hd-resolver Find the highest-resolution icon a domain publishes (SVG, apple-touch, Android, favicon) with dimensions - Tier: atomic ($0.005 USDC per call) - MCP tool: favicon_hd_resolver Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | domain | query | string | yes | Domain or URL, e.g. github.com | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/favicon-hd-resolver?domain=example.com" ``` MCP (tools/call arguments): `{"name":"favicon_hd_resolver","arguments":{"domain":"example.com"}}` ## GET /v1/avatar-initials-svg Generate a deterministic initials avatar SVG with an accessible text color - Tier: atomic ($0.005 USDC per call) - MCP tool: avatar_initials_svg Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | name | query | string | yes | Person or company name | | size | query | integer | no | Size in px (24-1024, default 128) | | shape | query | string | no | circle (default), rounded or square | | bg | query | string | no | Background color (default derived from the name) (hex, with or without #) | | fg | query | string | no | Text color (default chosen for contrast) (hex, with or without #) | | format | query | string | no | json (default, includes svg + data URI) or svg (raw image/svg+xml) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/avatar-initials-svg?name=example" ``` MCP (tools/call arguments): `{"name":"avatar_initials_svg","arguments":{"name":"example"}}` ## GET /v1/badge-shield-generator Generate a status badge SVG (label | message) in flat or flat-square style - Tier: atomic ($0.005 USDC per call) - MCP tool: badge_shield_generator Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | label | query | string | yes | Left label | | message | query | string | yes | Right message | | color | query | string | no | Message background color (default 2ea44f) (hex, with or without #) | | label_color | query | string | no | Label background color (default 555555) (hex, with or without #) | | style | query | string | no | flat (default) or flat-square | | format | query | string | no | json (default, includes svg + data URI) or svg (raw image/svg+xml) | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/badge-shield-generator?label=example&message=example" ``` MCP (tools/call arguments): `{"name":"badge_shield_generator","arguments":{"label":"example","message":"example"}}` ## GET /v1/aspect-ratio-calc Reduce dimensions to an aspect ratio, name the closest standard ratio, scale to a target and map to social-media presets - Tier: atomic ($0.005 USDC per call) - MCP tool: aspect_ratio_calc Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | width | query | integer | yes | Width | | height | query | integer | yes | Height | | target_width | query | integer | no | Scale to this width | | target_height | query | integer | no | Scale to this height | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/aspect-ratio-calc?width=1&height=1" ``` MCP (tools/call arguments): `{"name":"aspect_ratio_calc","arguments":{"width":"1","height":"1"}}` ## GET /v1/image-meta-inspector Inspect a remote image: format, dimensions, animation, alpha, size and content type from the file header - Tier: atomic ($0.005 USDC per call) - MCP tool: image_meta_inspector Parameters: | Name | In | Type | Required | Description | |---|---|---|---|---| | url | query | string | yes | Image URL | cURL: ```bash curl -H "X-Caelara-Key: $CAELARA_KEY" "https://media.caelaralabs.com/v1/image-meta-inspector?url=https%3A%2F%2Fexample.com" ``` MCP (tools/call arguments): `{"name":"image_meta_inspector","arguments":{"url":"https://example.com"}}`