Agent-CoreX Documentation

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 only the tools actually needed — cutting LLM costs by 30–70% and improving accuracy.

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. Key Benefits:

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

Before you begin, ensure you have:

A GitHub account (for signing up)
Node.js 16+ installed (for SDK usage)
A text editor or IDE
15 minutes of free time

Step 1: Create Your Account

Visit www.agent-corex.com/signup
Sign up with GitHub, Google, or email
Verify your email address
Accept the terms and conditions
Click “Get Started”

You’ll be redirected to your dashboard where you can create API keys, connect tools, and monitor usage.

Step 2: Create an API Key

Go to Dashboard → Settings → API Keys
Click “Create New Key”
Name your key (e.g., “Production”, “Development”)
Select the appropriate tier:
- Free: 1,000 requests/month
- Pro: 100,000 requests/month
- Enterprise: Custom limits
Click “Create”
Copy and save your key securely - it won’t be shown again!

Your API key will look like: acx_live_1a2b3c4d5e6f7g8h9i0j

Store Your Key Safely

Option 1: Environment Variable

export AGENT_COREX_API_KEY="acx_live_xxx"

Option 2: .env File

AGENT_COREX_API_KEY=acx_live_xxx

Option 3: Configuration File

const apiKey = process.env.AGENT_COREX_API_KEY;

Step 3: Install the SDK

Choose your language and install the SDK:

JavaScript/TypeScript

npm install agent-corex

Python

pip install agent-corex

Go

go get github.com/ankitpro/agent-corex-go

Step 4: Make Your First Call

JavaScript

import { AgentCorex } from 'agent-corex';

const agent = new AgentCorex({
  apiKey: process.env.AGENT_COREX_API_KEY
});

// Retrieve tools
const tools = await agent.retrieveTools({
  query: "Create a GitHub pull request",
  topK: 5
});

console.log('Available tools:', tools);
// Output: [
//   { name: 'create-pull-request', score: 0.98 },
//   { name: 'create-github-issue', score: 0.78 },
//   ...
// ]

// Execute a tool
const result = await agent.executeTool({
  toolName: 'create-pull-request',
  params: {
    repository: 'owner/repo',
    title: 'My first automated PR',
    from_branch: 'feature/x',
    to_branch: 'main'
  }
});

console.log('PR created:', result.pr_url);

Python

from agent_corex import AgentCorex

agent = AgentCorex(api_key="acx_live_xxx")

# Retrieve tools
tools = agent.retrieve_tools(
    query="Create a GitHub pull request",
    top_k=5
)

print("Available tools:", tools)

# Execute a tool
result = agent.execute_tool(
    tool_name="create-pull-request",
    params={
        "repository": "owner/repo",
        "title": "My first automated PR",
        "from_branch": "feature/x",
        "to_branch": "main"
    }
)

print("PR created:", result['pr_url'])

cURL

# Retrieve tools
curl -X POST "https://api.agent-corex.com/v1/retrieve_tools" \
  -H "Authorization: Bearer acx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Create a GitHub pull request",
    "top_k": 5
  }'

# Execute tool
curl -X POST "https://api.agent-corex.com/v1/execute_tool" \
  -H "Authorization: Bearer acx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "create-pull-request",
    "params": {
      "repository": "owner/repo",
      "title": "My first automated PR",
      "from_branch": "feature/x",
      "to_branch": "main"
    }
  }'

Next Steps

Create Your API Key

Detailed guide to securing your API key.

Setup MCP Servers

Connect GitHub, Slack, Jira, and more.

Reduce Token Usage

Optimize costs with smart tool routing.

Dashboard Guide

Explore your dashboard features.

Troubleshooting

API key not working?

Make sure you’re using the correct key format: acx_live_xxx
Check that the key hasn’t expired (30 days for trial keys)
Verify the environment variable is set: echo $AGENT_COREX_API_KEY
Try regenerating the key in your dashboard

Module not found error?

Make sure you installed the SDK:

npm install agent-corex  # JavaScript
pip install agent-corex  # Python

Connection timeout?

This usually means:

Your internet connection is unstable
The API server is temporarily unavailable
Try again in a few seconds

Want to see more examples?

Check out Real-World Workflows for complete, copy-paste ready examples.

Congratulations! You’ve successfully set up Agent-CoreX. You’re now ready to start automating with intelligent tool routing. 🚀 Next: Connect your first MCP server →

​Getting Started with Agent-CoreX

​What is Agent-CoreX?

​Prerequisites

​Step 1: Create Your Account

​Step 2: Create an API Key

​Store Your Key Safely

​Step 3: Install the SDK

​JavaScript/TypeScript

​Python

​Go

​Step 4: Make Your First Call

​JavaScript

​Python

​cURL

​Next Steps

Create Your API Key

Setup MCP Servers

Reduce Token Usage

Dashboard Guide

​Troubleshooting

Getting Started with Agent-CoreX

What is Agent-CoreX?

Prerequisites

Step 1: Create Your Account

Step 2: Create an API Key

Store Your Key Safely

Step 3: Install the SDK

JavaScript/TypeScript

Python

Go

Step 4: Make Your First Call

JavaScript

Python

cURL

Next Steps

Troubleshooting