get_data_sourcesLABSCO SUMMARY
Retrieval first, synthesis only when asked.
The tool set is deliberately ordered around search: semantic_search and grep_search are meant to be an agent's default, with the slower stateless chat kept as a last resort because it can take far longer than pulling the right artifacts. The distinction between the two searches is the useful part — grep matches filenames and paths literally, so it finds a config by name even when nothing inside it says so, while semantic search handles the 'where is the auth code' questions.
What it is
A server fronting CodeAlive's context engine for large codebases: 11 tools spanning semantic and literal search, file reads, repository orientation, call-graph relationships and metadata analytics over your indexed repositories.
What you get
- get_data_sources lists your indexed repositories and workspaces, so the agent knows what it can search before it starts
- semantic_search is the canonical retrieval across indexed artifacts, and grep_search does exact literal or regex search inside file content plus filename and path matching — returning a file like Form.xml even when its content never mentions the name
- get_repository_ontology gives repository-level orientation, get_file_tree inspects a bounded tree for one repository, and read_file reads a repo-relative path with an optional line range
- fetch_artifacts loads the full source for search hits and reports back identifiers it could not find rather than dropping them silently
- get_artifact_relationships expands the call graph, inheritance and reference edges around one artifact, so the agent follows structure rather than guessing
- get_artifact_query_schema shows the supported ArtifactQuery entities and fields, and query_artifact_metadata runs read-only metadata analytics across selected repositories
- chat is a slower, stateless synthesized Q&A over the codebase — a fallback the docs say to reach for only when a multi-step retrieval workflow will not do
Requirements
A CodeAlive account. Claude Code, Codex, Cursor and OpenCode sign in through the browser; other clients send a CodeAlive API key, created at app.codealive.ai under MCP & API, as an Authorization: Bearer header. The fastest path is the remote server at https://mcp.codealive.ai/api with no install; to run it yourself, use the ghcr.io/codealive-ai/codealive-mcp image over stdio, or self-host the HTTP transport.
Setup effort
One command plus a key — claude mcp add --transport http codealive https://mcp.codealive.ai/api, then supply credentials
USE CASES
Finding the code behind a feature
Search semantically for the concept — authentication, the payment flow — then load the full source of the strongest hits, following call-graph relationships to the pieces they connect to.
Locating something by an exact string or name
Run a literal or regex search inside file content, or match a filename directly, to pin down the exact pattern or the config file you know by name.
Getting oriented in an unfamiliar repository
List the indexed data sources, pull the repository ontology for orientation, and inspect a bounded file tree before diving into any one file.
Asking a question of the codebase's structure
Inspect the query schema, then run read-only metadata analytics across the repositories to answer a structural question without reading every file.
11 tools
Listed in project docs. Your client may show a different list.
semantic_searchgrep_searchget_repository_ontologyget_file_treeread_filefetch_artifactsget_artifact_relationshipsget_artifact_query_schemaquery_artifact_metadatachatBEFORE YOU INSTALL
What to know first
Tools you get
11 tools named in the project's documentation.
Requires
- A client that can reach a remote MCP server over HTTP
- A CodeAlive account (app.codealive.ai)
INSTALLATION
Connect your client
Server setup
claude mcp add
claude mcp add --transport http codealive https://mcp.codealive.ai/apiHosted endpoint
https://mcp.codealive.ai/apiAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Claude Code
claude mcp add --transport http codealive https://mcp.codealive.ai/apiThen start Claude Code and run /mcp to sign in to CodeAlive in the browser — no API key is stored.
Codex
codex mcp add codealive --url https://mcp.codealive.ai/apiThen run codex mcp login codealive to sign in to CodeAlive in the browser — no API key is stored.
Cursor
{
"mcpServers": {
"codealive": {
"url": "https://mcp.codealive.ai/api"
}
}
}Cursor discovers CodeAlive's OAuth sign-in from this URL and opens the browser; if it does not prompt, run cursor-agent mcp login codealive.
OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"codealive": {
"type": "remote",
"url": "https://mcp.codealive.ai/api",
"enabled": true
}
}
}OpenCode discovers CodeAlive's OAuth sign-in from this URL; restart it and follow the browser prompt, or run opencode mcp auth codealive.
Any MCP client
Endpoint:
https://mcp.codealive.ai/apiTransport: Streamable HTTP
Authentication header: Authorization: Bearer <YOUR_API_KEY> — your CodeAlive API key
Enter these in your client's own MCP settings, in whatever format it uses.