Documentation
6 REST endpoints and 4 MCP tools, in one reference.
This page is the at-a-glance index of everything AIUseCaseHub exposes programmatically. Use the REST page to test calls interactively and manage your key, or the MCP page to wire the corpus into an agent.
REST base URL
https://basic-backend713-dsd8hygyfkc8d8f5.swedencentral-01.azurewebsites.net/apiMCP endpoint
https://basic-backend713-dsd8hygyfkc8d8f5.swedencentral-01.azurewebsites.net/api/mcpREST
HTTP endpoints
All calls require the X-API-Key header.
| Method | Path | Purpose | Params | Credits |
|---|---|---|---|---|
| GET | /usecasesList Use Cases | Retrieve AI use cases with optional filtering and pagination. Returns curated real-world AI implementations across industries. | 14 | 1 |
| GET | /hybrid-searchHybrid Search | Search use cases with native hybrid ranking that combines full-text relevance and vector similarity. This is the recommended discovery endpoint and matches the default in-app search behavior. | 20 | 2 |
| GET | /get_usecase_by_key/{row_key}Get Use Case Details | Retrieve detailed information about a specific use case including architecture description, challenges, solutions, and impact metrics. | 1 | 1 |
| GET | /embeddings-searchSemantic Search | Perform semantic search using AI embeddings. Find use cases based on meaning rather than exact keyword matches. Ideal for discovering similar implementations. | 2 | 2 |
| POST | /get_similar_casesFind Similar Cases | Find use cases similar to a given case using vector similarity. Useful for discovering related implementations and patterns. | 2 | 2 |
| GET | /statisticsGet Statistics | Retrieve aggregated statistics about the use case database including counts by provider, geography, industry, and technology. | 0 | 1 |
MCP
Agent tools
Exposed by the remote MCP server at https://basic-backend713-dsd8hygyfkc8d8f5.swedencentral-01.azurewebsites.net/api/mcp.
| Tool | Mode | Purpose | Arguments | Credits |
|---|---|---|---|---|
search_usecases | Hybrid search | Default agent search tool. Preserves the existing search_term contract while using hybrid full-text plus vector ranking behind the scenes. | search_term, limit | 2 |
hybrid_search_usecases | Hybrid search | Explicit hybrid search tool for agents that want natural-language query semantics and combined ranking scores. | query, limit | 2 |
vector_search_usecases | Vector search | Semantic-only tool for similarity search when keyword matching is not needed. | query, limit | 2 |
get_usecase_details | Detail lookup | Fetch the detailed record for a specific use case returned by a search tool. | row_key | 1 |