Agent-CoreX
Getting Started

Getting Started with Agent-CoreX

Agent-CoreX is a tool router for AI agents. Instead of sending your agent every available tool on every request, Agent-CoreX dynamically selects the 5% of tools actually needed — cutting LLM costs by 30–70% and improving accuracy.

Last updated: April 2026

What is Agent-CoreX?

Agent-CoreX sits between your AI agent and your tools. When your agent needs a tool, it queries Agent-CoreX with a natural-language description. Agent-CoreX returns only the most relevant tools — preventing token bloat caused by passing hundreds of tool schemas in every LLM call.

60% avg cost reduction

By routing only the tools your agent needs, you stop wasting tokens on irrelevant schemas.

API-key authentication

Keys start with acx_ and are hashed before storage — never stored in plaintext.

MCP-native

Connect VS Code, Cursor, Claude Code, Windsurf, and more via a single SSE endpoint.

Prerequisites

  • •A free Agent-CoreX account (you'll create one in Step 1)
  • •Python 3.8+ (for the SDK) or any language for direct API calls
  • •An existing AI agent or LLM workflow where you want to reduce tool token usage

Setup Steps

1

Create your account

Go to agent-corex.com/signup and sign up. Three methods are available:

  • Continue with Google — one-click OAuth via your Google account
  • Continue with GitHub — one-click OAuth via your GitHub account
  • Email + password — enter your email and choose a password

After sign-up, you are automatically redirected to /dashboard.

2

Create an API key

Navigate to Dashboard → API Keys. Click the "New key" button in the top-right corner of the Keys section.

Enter a name for the key (e.g. Production, Dev, or Testing), then click "Create key".

⚠The key is shown once only. Copy it immediately — it will not be displayed again. The dashboard stores only a SHA-256 hash and the first 12 characters (prefix) for identification.

Your key will look like: acx_a1b2c3d4e5f6...

3

Install the SDK

Install the Agent-CoreX Python SDK:

bash
pip install agent-corex

Verify the install:

bash
agent-corex --version
4

Make your first call

Set your API key as an environment variable (recommended) or pass it directly:

bash
export AGENT_COREX_API_KEY="acx_your_key_here"

Then route a tool query:

example.py
import agent_corex

client = agent_corex.Client(api_key="acx_your_key_here")

# Retrieve the 5 most relevant tools for your query
tools = client.retrieve_tools(
    query="read files from disk",
    top_k=5
)

for tool in tools:
    print(tool.name, tool.description)

You can also call the REST API directly with your key in the Authorization header:

bash
curl "https://api.agent-corex.com/retrieve_tools?query=read+files&top_k=5" \
  -H "Authorization: Bearer acx_your_key_here"

Next steps

Connect your IDE via MCP

Add Agent-CoreX as an MCP server to VS Code, Cursor, Claude Code, and more.

MCP Setup →

Track your usage

Monitor query volume, daily averages, peak usage days, and estimated cost savings.

View usage guide →

Manage API keys

Create keys per environment, view last-used timestamps, and revoke access instantly.

API key guide →

Understand tool retrieval

Learn how Agent-CoreX uses hybrid vector + keyword scoring to find the right tools.

Learn more →