Product · API & MCP Integrations

Build custom reputation intelligence into your tools.

REST API, an MCP server for AI agents, webhooks for real-time events, and official SDKs in 4 languages. Pull Harch reputation scores, risk signals, and sentiment into your BI stack, your CRM, or your AI assistant — wherever decisions get made.

10K

API calls / day — Corporate plan

100K

API calls / day — Sovereign

4

official SDKs (Python, TS, Go, Ruby)

99.9%

API uptime SLA

Quick start

Make your first call in 30 seconds.

Pick a language, drop in your API key, and pull a reputation score for any company. Same shape across every SDK — switch languages without relearning the surface area.

python

from harch import HarchClient

client = HarchClient(api_key="sk_...")

result = client.reputation.score(company="Bank of Africa")
print(result.score)        # 78
print(result.pillars)      # {innovation: 82, performance: 76, purpose: 71}
print(result.sentiment)    # {positive: 0.68, neutral: 0.22, negative: 0.10}

Endpoints

8 endpoints that cover 90% of use cases.

Every endpoint is rate-limited per API key, returns JSON, and is documented with request samples in Python, TypeScript, cURL, and MCP.

MethodPathDescription

GET/v1/reputation/scoreGet company reputation score

GET/v1/reputation/pillarsGet Innovation / Performance / Purpose pillars

GET/v1/sentiment/analyzeAnalyze sentiment of text

GET/v1/risks/detectDetect 32 risk categories

GET/v1/articles/searchSearch articles with filters

GET/v1/companies/compareCompare competitors

POST/v1/alerts/subscribeSubscribe to WhatsApp alerts

GET/v1/harch100Get Harch 100 ranking

Webhooks

Get pushed when reputation moves.

Subscribe to four event types. We POST JSON to your endpoint within 60 seconds of detection, retry with exponential backoff for 24 hours, and sign every payload with an HMAC-SHA256 header.

reputation.score_changedScore delta > 5 points

risk.spike_detectedRisk velocity > 50%

sentiment.shift_alertSentiment shift > 10% in 24h

narrative.emergingNew narrative detected

Example payload · reputation.score_changed

json

{
  "event": "reputation.score_changed",
  "timestamp": "2026-07-15T09:30:00Z",
  "data": {
    "company": "Bank of Africa",
    "previous_score": 72,
    "current_score": 78,
    "delta": 6.0,
    "pillar_changes": {
      "innovation": 4,
      "performance": 8,
      "purpose": 6
    }
  },
  "delivery_id": "evt_01HZ8KQ3P4X2V7N9Y6B5C1D2E3"
}

SDKs

Official SDKs in 4 languages.

P

Python

$pip install harch

T

TypeScript

$npm install @harch/sdk

G

Go

$go get github.com/harchcorp/harch-go

R

Ruby

$gem install harch

Model Context Protocol

Bring Harch data into the AI assistant you already use.

The Harch MCP server exposes 7 tools — reputation scoring, risk detection, sentiment, article search, comparison, and the Harch 100 ranking — to any MCP-compatible AI client. No glue code, no copy-paste, no API plumbing.

One config, four clients

{
  "mcpServers": {
    "harch": {
      "command": "npx",
      "args": ["-y", "@harch/mcp-server"],
      "env": { "HARCH_KEY": "sk_..." }
    }
  }
}

C

Claude

Add Harch MCP server in Claude Desktop or claude.ai to query reputation data in conversation

G

ChatGPT

Use the Harch Custom GPT or wire MCP server to ChatGPT for live reputation lookups

↗

Cursor

Drop-in MCP server for the Cursor code editor — fetch company data while you build

W

Windsurf

Add Harch MCP to Windsurf agents for reputation-aware research workflows

Rate limits

Corporate vs Sovereign, side by side.

ResourceCorporateSovereign

API calls / day10,000100,000

Requests / minute1001,000

Concurrent requests550

Webhook deliveries / month10,000Unlimited

MCP tool calls / day2,00050,000

Article search results / query1001,000

Data retention90 days2 years

SLABest effort99.9% uptime

Authentication

Two ways to authenticate. Both enterprise-grade.

Start with a static API key for personal scripts and proof-of-concept integrations. Move to OAuth 2.0 when you ship to production and need scoped tokens, refresh flows, and per-user audit logs.

API keys

Static bearer tokens. Scoped per environment (dev / staging / prod). Rotatable from the dashboard.

OAuth 2.0

Authorization-code flow with PKCE. Refresh tokens, scoped permissions, per-user audit trail.

Example · Bearer token header

http

GET /v1/reputation/score?company=Bank+of+Africa HTTP/1.1
Host: api.harchcorp.com
Authorization: Bearer sk_live_a1b2c3d4e5f6...
Accept: application/json
X-Harch-Client: my-crm-integration/1.4.0

Get API access.

Corporate keys ship in 5 minutes from the dashboard. Sovereign plans include a dedicated integration engineer and a 99.9% uptime SLA.

Get API access →