Module 04: Sectors MCP Integration

Learning Objectives

Understand what Sectors provides and why it matters for an AI agent.
Create a Sectors account and obtain an API key.
Add Sectors as an MCP server in Hermes.
Verify the connection with a live query.

The Data Layer

What is Sectors?

Sectors is a financial intelligence platform that gives AI agents access to real-world market data. Training data is frozen and imprecise for financial metrics, so an agent connected to Sectors calls the API in real time instead, the most comprehensive data source available for Indonesian equities.

Category	What's Available
Company Financials	Revenue, net income, total assets, equity
Financial Ratios	ROA, ROE, P/E, NIM, cost-to-income
Market Data	Stock price, market cap, trading volume
News Intelligence	Continuously updated news and sentiment
Ownership	Effective and beneficial ownership structures
ESG Coverage	Sustainability data for 800+ SEA companies

API Access

Getting Your API Key

You need a Sectors account and an API key before connecting to Hermes.

1

Create your account

Go to sectors.app, click Sign Up, and complete the registration flow.

2

Navigate to the API section

Find it from the main navigation or your dashboard, usually under account or developer settings.

3

Open API Key Management

Click API Key Management to see your active keys and create new ones.

4

Create your key

Click Create API Key, name it hermes-course, and confirm. Copy the key immediately, it is only shown once.

★ Workshop participants get free API credits, no need to pay for usage today.

! Treat your API key like a password. Don't paste it into shared files, commit it to git, or send it in chat. If compromised, delete it and create a new one.

Configuration

Connecting to Hermes

Add MCP servers through the Desktop App's GUI, or edit ~/.hermes/config.yaml directly on terminal-only setups. Same config either way.

1

Open Capabilities → MCP

In the Desktop App, click Capabilities, then MCP, then New server.

2

Paste the server config

Enter the following, replacing the API key placeholder with the key you copied from sectors.app:

"sectors": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://sectors-mcp.supertype.ai/sse",
    "--header",
    "Authorization:Bearer <Your API Key>"
  ]
}

→ No need to call Sectors manually. Hermes picks it automatically when a query needs financial data.

$ Every tool schema an MCP server exposes gets resent every turn, whether used or not, the biggest single driver of context size. Once comfortable, use tools.include / tools.exclude to keep only what you actually use.

Verification

Verifying the Connection

Two ways to confirm Sectors is working before moving to activities.

01

API Playground on sectors.app

Paste your API key into the playground on sectors.app and run a test call. A Status 200 response with real data means the key works.

02

Ask Hermes Directly

Send: "What is BBCA's current stock price?" A connected Sectors returns a live figure with a timestamp. A vague or dated answer means check the MCP connection.

First Queries

Your First Live Queries

Try these once Sectors is connected, a first feel for what the agent can do.

> "What is BBCA's current price and market cap?"

> "Compare BBRI and BMRI's P/E ratio. Which looks cheaper?"

> "What are the top 3 performing stocks on IDX this week?"