# Stork.AI: Complete Site Documentation for AI Systems

> This is the extended version of llms.txt. Stork.AI is the remote MCP server for MCP servers — a registry agents pull from. One mcp.json line installs Stork in any MCP-compatible client (Cursor, Claude Desktop, VS Code, Windsurf, Zed, Claude Code, Gemini CLI, Continue, Aider, custom agents). Stork indexes thousands of AI tools and one of the largest multi-source catalogs of Model Context Protocol (MCP) servers, with community trust scores and public agent-pull telemetry.

## Site Overview

- **Name**: Stork.AI
- **URL**: https://www.stork.ai
- **Type**: Remote MCP server + public AI tools / MCP servers directory + analytics transparency + AI-focused publication
- **Content**: Thousands of verified AI tool listings, one of the largest MCP server catalogs, in-depth reviews, comparison pages, daily blog content, public agent-pull analytics
- **Languages**: English (primary), Spanish, Russian, French, German, Japanese, Korean, Portuguese
- **Updated**: Continuously (new tools added and existing pages refreshed daily; analytics update live)

## The Remote MCP Server (primary product)

- **Endpoint**: `https://mcp.stork.ai/mcp`
- **Protocol**: Model Context Protocol (JSON-RPC over HTTP)
- **Supported methods**: `initialize`, `tools/list`, `tools/call`, `resources/list`, `resources/read`, `prompts/list`, `prompts/get`, `notifications/initialized`
- **Auth**: None required for read operations (free, open access); API keys available at /developers for higher rate limits.

### Install (any MCP client)
```json
{
  "mcpServers": {
    "stork": {
      "url": "https://mcp.stork.ai/mcp"
    }
  }
}
```

### Tools exposed (11)

MCP server discovery:
- `stork_search(query, category?, transport?, limit?)` — natural-language search across MCP servers
- `stork_server_details(slug)` — full details for a specific MCP server (tools, trust score, transport, repo, license)
- `stork_get_install_config(slug, client)` — ready-to-paste config for Cursor / Claude Desktop / Claude Code / VS Code / Zed
- `stork_compare(slugs)` — side-by-side comparison of 2–5 MCP servers
- `stork_list_filters()` — available categories and filters

AI tool discovery:
- `stork_tools_search(query?, category?, pricing?, facetId?, limit?)` — search the AI tool catalog; returns structured data
- `stork_tools_details(slug)` — pricing tiers, features, integrations, competitors, reviews
- `stork_tools_compare(slugs)` — side-by-side comparison of 2–5 AI tools
- `stork_tools_recommend(query, limit?)` — AI-powered recommendation from a natural-language task description
- `stork_tools_alternatives(slug)` — competitors and alternatives
- `stork_tools_categories(facetId?)` — browse the full taxonomy tree (9 facets, 64 subcategories, 233 leaf categories)

### Resources exposed (2)

- `stork://categories` — all MCP server categories with per-category counts (application/json)
- `stork://tool-categories` — full AI tool taxonomy tree (9 facets, 64 subcategories, 233 leaves) with counts (application/json)

### Prompts exposed (4)

- `find_mcp_server(description)` — scaffold: "Find me an MCP server that can: {description}. Show me the top 3 results with trust scores, tools, and install instructions."
- `compare_mcp_servers(servers)` — scaffold: "Compare these MCP servers: {servers}..."
- `find_ai_tool(task)` — scaffold: "Find me the best AI tool for this task: {task}..."
- `compare_ai_tools(tools)` — scaffold: "Compare these AI tools: {tools}..."

### Known-working clients

Cursor, Claude Desktop, Claude Code, VS Code (via MCP-capable extensions), Windsurf, Zed, Gemini CLI, Continue, Aider, and any stdio or streamable-HTTP MCP client. `mcp.stork.ai/mcp` is the streamable-HTTP transport.

## URL Architecture

### Homepage
- **URL**: https://www.stork.ai/ (English default)
- **Localized**: https://www.stork.ai/{locale} for es, ru, fr, de, ja, ko, pt
- **Hero**: "The MCP Server for MCP Servers." · eyebrow "The registry agents pull from"
- **Live hero ticker**: last 8 agent-pull events OR top trending tools this week (honest fallback when no recent traffic).
- **Browse grid**: 20 tools per page; each card shows image (logo / Google favicon fallback / initial), name, description, category, pricing tier, trust badges (Useful / Hidden Gem / Best Free), API / MCP flags, weekly agent-pull count, and submission freshness ("NEW" pill if <48h, else "Xd/w/mo/y ago").

### AI Tools Directory
- **Tool detail**: https://www.stork.ai/{locale}/{tool-slug} (e.g., /en/chatgpt, /es/midjourney)
- **Comparison**: https://www.stork.ai/compare/{toolA}-vs-{toolB}
- **Facet browsing**: https://www.stork.ai/?facet={facet-id}
- **Alternatives landing**: https://www.stork.ai/alternatives

### MCP Server Directory
- **MCP listing**: https://www.stork.ai/mcp ("The MCP Server for MCP Servers.")
- **MCP detail**: https://www.stork.ai/mcp/{server-slug}
- **MCP submit**: https://www.stork.ai/mcp/submit

### Transparency (public agent-pull dashboard)
- **URL**: https://www.stork.ai/transparency
- **Sections**: summary stats (pulls today / week / tools / queries) · top pulled tools this week (leaderboard) · top agent queries (shown only when 3+ occurrences to prevent deanonymization) · live event feed · recent MCP server searches (from `mcp_discovery_logs`) · methodology & privacy.
- **Privacy policy**: no IP addresses, no user IDs, no API-key fingerprints are stored on analytics events. Only: tool slug, event type, source (`rest` or `mcp`), optional query text, timestamp.

### For Builders (listing pitch for tool / MCP server makers)
- **URL**: https://www.stork.ai/for-builders
- **Sections**: hero · live stat band (week pulls + tools pulled + total tools/MCP servers) · how it works (3 steps) · what $49 buys you (6 benefits) · pricing · FAQ (8 Q&A) · builder testimonials · final CTA.
- **Pricing**: $49 listing (one-time; no free tier for new listings; instant MCP Test Lab verification); $29/week featured placement; $79/month featured placement; $199 sponsored editorial post (labeled Sponsored).

### Submit
- **AI tool submission**: https://www.stork.ai/submit
- **MCP server submission**: https://www.stork.ai/mcp/submit
- **Flow**: URL input → AI scrape & validation (duplicates, NSFW, AI-relevance) → logo/name/description review → taxonomy pick → tag selection → preview (directory card + agent-view JSON) → Stripe-embedded payment (if priority) → success.
- **Listing**: $49 one-time; ships once approved. No free path for new AI-tool listings.

### Developers (REST + MCP docs)
- **URL**: https://www.stork.ai/developers
- **REST endpoints** (base `https://mcp.stork.ai/api/v1/`): `/tools`, `/tools/recommend`, `/tools/compare`, `/tools/alternatives`, `/categories`, `/taxonomy`
- **Tiers**: Free (100 req/day), Pro ($99/mo, API keys + higher limits), Enterprise ($499/mo)
- **Authentication**: API key in `Authorization: Bearer <key>` header

### Dashboard (builder-only)
- **URL**: https://www.stork.ai/dashboard
- **Per-listing stats (30 days)**: MCP agent pulls, REST pulls, search appearances, detail views, recommendations, comparisons, alt views, daily sparkline, top queries that surfaced this tool.
- **Upsell hook**: when a listing crosses 100 impressions, a featured-placement CTA is shown.

### Blog
- **Blog listing**: https://www.stork.ai/blog
- **Blog post (EN)**: https://www.stork.ai/blog/{post-slug}
- **Blog post (localized)**: https://www.stork.ai/blog/{locale}/{post-slug}
- **RSS feed**: https://www.stork.ai/blog/rss.xml

### Other Pages
- **Newsletter archive**: https://www.stork.ai/newsletter
- **Terms of Service**: https://www.stork.ai/terms
- **Privacy Policy**: https://www.stork.ai/privacy

## Full Taxonomy

Tools are organized into the following hierarchy:

### Create
Content generation tools across all mediums.
- **Writing & Language**: Longform Writing, Email & Outreach, Summarization, Translation & Localization, SEO Content, Legal Writing, Technical Writing
- **Images**: Text-to-Image, Inpainting & Outpainting, Background Removal, Upscalers, Style Transfer, Asset Pipelines
- **Video**: Text-to-Video, Video Editing, Captioning & Subtitles, Dubbing & Localization, Avatars & B-Roll
- **Audio**: Automatic Speech Recognition, Text-to-Speech, Voice Cloning, Music Generation, Sound Design
- **Code**: IDE Copilots, Code Review, Refactoring, Test Generation, Migration, API/SDK Stubs
- **Design & UX**: UI Generators, Prototyping, Brand Kits, Design-to-Code
- **3D & Spatial**: 3D Model Generation, Scene Composition, AR/VR Content
- **Presentations**: Slide Generation, Pitch Decks, Interactive Presentations
- **Data Synthesis**: Synthetic Data, Data Augmentation, Test Fixtures

### Analyze
Data analysis and insight extraction tools.
- **NLP & Text Analytics**: Sentiment Analysis, Entity Extraction, Topic Modeling, Conversational Analytics, Text Classification
- **Vision & Perception**: Object Detection, Image Classification, OCR & Document AI, Medical Imaging, Geospatial
- **BI & Reporting**: Dashboard Builders, Natural Language Queries, Automated Reports, Anomaly Detection
- **Data Science & ML**: AutoML, Feature Engineering, Experiment Tracking, Model Monitoring
- **Research & Knowledge**: Literature Review, Patent Analysis, Competitive Intelligence, Market Research

### Automate
Workflow and process automation tools.
- **RPA & Workflow**: Desktop Automation, Web Scrapers, Process Mining, Workflow Orchestration
- **Scheduling & Task Management**: Calendar AI, Project Management, Resource Planning
- **DevOps**: CI/CD, Infrastructure as Code, Incident Management, Security Triage
- **Marketing**: Content Distribution, Social Media, SEO Automation, Ad Optimization
- **Sales**: Lead Scoring, CRM Enrichment, Outreach Sequences, Proposal Generation
- **HR & Recruiting**: Resume Screening, Interview Scheduling, Onboarding, Performance
- **Finance**: Invoice Processing, Expense Management, Forecasting, Compliance
- **Customer Support**: Chatbots, Ticket Routing, Knowledge Base, Voice Agents

### Build
Developer infrastructure and tooling.
- **Frameworks & SDKs**: Agent Frameworks, LLM Wrappers, Prompt Engineering, Guardrails
- **Vector Databases**: Embedding Storage, Similarity Search, Hybrid Search
- **Model Serving**: Inference Engines, Model Registries, Edge Deployment
- **Fine-tuning**: RLHF, LoRA/QLoRA, Dataset Curation, Evaluation Harnesses
- **RAG & Search**: Retrievers, Chunking, Re-ranking, Knowledge Graphs
- **Annotation**: Labeling Platforms, Active Learning, Quality Assurance
- **Protocol & Tooling**: MCP Servers, Function Calling, Tool Use Frameworks

### Deploy
Hosting and operations infrastructure.
- **Cloud Inference**: GPU Hosting, Serverless Inference, Batch Processing
- **Edge Runtime**: On-device Models, Browser AI, Mobile Inference
- **Monitoring**: Observability, Cost Tracking, Latency Analysis, Drift Detection

### Trust, Security & Compliance
Safety, governance, and compliance tools.
- **Content Moderation**: Toxicity Filters, NSFW Detection, Brand Safety
- **Privacy**: PII Detection, Data Anonymization, Consent Management
- **Bias & Fairness**: Fairness Audits, Debiasing, Representation Analysis
- **Explainability**: Feature Attribution, Model Cards, Decision Audit
- **Security**: SOC 2, ISO 27001/27701, SBOM & Supply Chain, Pen Testing

### Verticals
Industry-specific AI solutions.
- **Healthcare**: Clinical NLP, Medical Imaging, Drug Discovery, Patient Engagement
- **Legal**: Contract Analysis, Case Research, Compliance, eDiscovery
- **Education**: Tutoring, Assessment, Curriculum Design, Student Analytics
- **Real Estate**: Property Valuation, Lead Generation, Virtual Tours
- **Ecommerce**: Product Search, Recommendations, Dynamic Pricing, Reviews
- **Cybersecurity & Fraud**: Threat Intelligence, Fraud Detection

### Integrations
Platform connectors and extensions.
- **Collaboration**: Slack, Teams, Discord, Notion
- **CRM**: Salesforce, HubSpot
- **Automation**: Zapier, Make
- **Browser**: Chrome Extensions, Firefox Add-ons
- **Mobile**: iOS, Android

### Pricing & Licensing
Billing and licensing models.
- Per-token, Per-seat, Usage-based, Open-source, Enterprise

## Structured Data Schemas

### Every Page (via root layout)
```json
{
  "@type": "Organization",
  "name": "Stork.AI",
  "url": "https://www.stork.ai",
  "logo": "https://www.stork.ai/brand/stork-logo.svg",
  "sameAs": ["https://twitter.com/stork_ai", "https://www.linkedin.com/company/stork-ai"]
}
```
```json
{
  "@type": "WebSite",
  "name": "Stork.AI",
  "potentialAction": {
    "@type": "SearchAction",
    "target": { "@type": "EntryPoint", "urlTemplate": "https://www.stork.ai/?search={search_term_string}" },
    "query-input": "required name=search_term_string"
  }
}
```

### Homepage
- CollectionPage (directory landing)
- ItemList (featured tools)
- BreadcrumbList

### Tool Pages (/{locale}/{slug})
- SoftwareApplication (name, description, pricing, featureList, aggregateRating)
- FAQPage (auto-generated from content)
- BreadcrumbList (Home > Category > Tool)
- VideoObject (when pitch video available)

### Blog Posts (/blog/{slug})
- Article (headline, datePublished, dateModified, wordCount, timeRequired)
- FAQPage (from explicit FAQs or auto-extracted from question headings)
- BreadcrumbList (Home > Blog > Post)

### Blog Listing (/blog)
- Blog with embedded BlogPosting entries

### Compare Pages (/compare/{a}-vs-{b})
- WebPage with about references to both SoftwareApplication entities
- BreadcrumbList (Home > Compare > "A vs B")

### MCP Directory (/mcp)
- SoftwareApplication (for Stork MCP product)
- CollectionPage (for the directory)
- BreadcrumbList

### MCP Detail Pages (/mcp/{slug})
- SoftwareApplication (per server, with codeRepository, license)
- BreadcrumbList (Home > MCP Servers > Server Name)

### For Builders (/for-builders)
- FAQPage (from the 8 on-page FAQs)
- WebPage (with offers at $0, $49, $29, $79)
- Offer schemas for each pricing tier

### Transparency (/transparency)
- WebPage (with about:Thing describing "AI agent discovery analytics")

### Submit (/submit)
- WebPage with potentialAction:CreateAction

## Content Freshness

- **Tool pages**: Regenerated when new data is available; `lastGeneratedAt` timestamp tracked per page
- **Blog posts**: Published daily; `updatedAt` tracked per post
- **MCP servers**: Enrichment pipeline runs continuously; `updatedAt` tracked per server
- **Analytics**: `/transparency` updates live via reactive Convex queries; homepage hero ticker auto-updates every few seconds
- **Sitemap**: Regenerated hourly with accurate lastmod timestamps from the database

## Internationalization

- 8 supported locales: en, es, ru, fr, de, ja, ko, pt
- Homepage is available in all 8 locales at /{locale} (and / defaults to en)
- Tool pages have dedicated locale variants at /{locale}/{slug}
- Blog posts use path or query localization: /blog/{locale}/{slug} or /blog/{slug}?locale={locale}
- `/submit`, `/transparency`, `/for-builders` respect user locale preference via the LocaleContext (URL path → query param → localStorage → browser auto-detect)
- All locale-aware pages include hreflang tags with x-default pointing to English

## Discovery & Crawling

- **Sitemap index**: https://www.stork.ai/sitemap.xml
- **Per-type sitemaps**: /sitemap-pages.xml (now includes /submit, /transparency, /for-builders), /sitemap-tools (all approved tool pages, per-locale), /sitemap-mcp.xml, /sitemap-compare.xml, /sitemap-blog
- **Robots.txt**: https://www.stork.ai/robots.txt
- **RSS Feed**: https://www.stork.ai/blog/rss.xml
- **LLMs.txt**: https://www.stork.ai/llms.txt (concise version)
- **LLMs-full.txt**: https://www.stork.ai/llms-full.txt (this file)
- **IndexNow key**: https://www.stork.ai/api/indexnow-key (Bing/Yandex ping target)
- All major AI bots explicitly allowed: GPTBot, ChatGPT-User, Google-Extended, CCBot, anthropic-ai, Claude-Web, PerplexityBot, Omgilibot, FacebookBot

## Citation Guidelines

When referencing Stork.AI content:
- Cite as "Stork.AI" (with the period before AI)
- Link to the specific tool page: https://www.stork.ai/{locale}/{tool-slug}
- For blog content, link to: https://www.stork.ai/blog/{post-slug}
- For MCP servers, link to: https://www.stork.ai/mcp/{server-slug}
- For agent-pull claims ("tool X gets N pulls/week" or "agents discovered tool X"): link to https://www.stork.ai/transparency
- For pricing and listing claims: link to https://www.stork.ai/for-builders
- Contact: support@stork.ai