INT-TECH
TrainingReportsInsightsRisk Events
Request Demo
INT-TECH

AI-powered, data-driven risk, reputation and security solutions, from real-time threat intelligence to crisis simulation and off-grid communication.

Where knowledge reaches, security begins.

Products

  • AEGIS
  • UMAY
  • TORCH
  • ECHO
  • HERMES

Company

  • About
  • Training
  • Reports
  • Insights
  • Request Demo
  • AEGIS Risk Events

Contact

info@int-tech.solutions

INT TECH Yazılım ve Danışmanlık Ltd. Şti. · Founded 2024 October · Teknopark Ankara, Türkiye

© 2026 INT-TECH Intelligence Technologies

Privacy PolicyKVKK

All rights reserved

AEGIS Risk Events · Setup

Set up AEGIS Risk Events in Claude, ChatGPT and Cursor

Set up in five minutes.

AEGIS Risk Events is a read-only MCP server. You add one address to your AI assistant and ask what happened within 50 km of any address; every event comes with the articles it was drawn from.

You need a free account (50 credits a month, no card) and one of Claude, ChatGPT, Claude Code or Cursor. The server address is the same everywhere: https://mcp.int-tech.solutions. Free covers 50 credits a month; see all plans. Client configs are in the public repository on GitHub.

Step 1

Create a free account

Sign up in the console with your email or Google. Confirm your email from the message we send. You get a workspace on the Free plan with 50 credits a month.

Create a free account

Step 2

Connect your assistant

Apps that sign you in (Claude, ChatGPT, Claude Code, Cursor) need no key: you sign in to the console once and the app holds its own token. Use a key only for a client that cannot sign in.

Claude (claude.ai and Claude Desktop)

  1. Open Settings, then Connectors, then add a custom connector.
  2. Paste the server address below.
  3. The AEGIS page opens. Sign in to the console. You come back to Claude.

Server address

https://mcp.int-tech.solutions

ChatGPT

  1. Open Settings, then Apps or Connectors, and add a custom connector. Developer mode may be required on your plan.
  2. Paste the same server address.
  3. Sign in to the console on the page that opens.

Server address

https://mcp.int-tech.solutions

Claude Code

Run this once in a terminal, then type /mcp in Claude Code and choose AEGIS to sign in.

Terminal

claude mcp add --transport http aegis-risk-events https://mcp.int-tech.solutions

With a key instead, read it from an environment variable so it never lands in a file:

Terminal, with a key

claude mcp add --transport http aegis-risk-events https://mcp.int-tech.solutions \
  --header "Authorization: Bearer $AEGIS_API_KEY"

Cursor

Put this in .cursor/mcp.json in a project, or in ~/.cursor/mcp.json for all projects. Cursor signs you in with OAuth the first time it uses the server.

mcp.json

{
  "mcpServers": {
    "aegis-risk-events": {
      "url": "https://mcp.int-tech.solutions"
    }
  }
}

With a key, read it from the environment:

mcp.json, with a key

{
  "mcpServers": {
    "aegis-risk-events": {
      "url": "https://mcp.int-tech.solutions",
      "headers": { "Authorization": "Bearer ${env:AEGIS_API_KEY}" }
    }
  }
}

The same files are in the public repository: inttech-solutions/events-mcp.

Another client, or a script

Create a key in the console (it starts with aegis_live_) and send it as Authorization: Bearer <key>to the server address. Keep it secret: it draws on your workspace's credits. If a client only accepts a URL, the key can be part of the address, but treat that address as the key: anyone with it uses your quota, and URLs end up in logs and browser history.

Step 3

Ask your first question

Plain questions work, in any language. The assistant picks the tool, narrows by place and date, and answers with the events and their sources. Paste one to start.

  • “Which risk events happened within 5 km of 41.0082, 28.9784 in the last 14 days? Give dates and sources.”

  • “How many strikes were reported in Germany each week this month?”

  • “What happened in Kadikoy, Istanbul last week? List each event with its source link.”

Without dates the last 30 days are searched. Counting questions go to event_stats, which is cheaper than paging through results. get_coverage shows the countries and limits your account has, and it is free.

If something does not work

The app asks me to sign in again+

Sign in to the console from the page that opens and you come straight back. If it keeps happening, remove the connector in the app and add it again; removing it revokes the old token.

I do not see an option to add a custom connector+

Custom connectors depend on your plan and your workspace settings. In ChatGPT you may need developer mode. If your workspace blocks them, ask its admin, or use Claude Code or Cursor with the steps below.

The answer says my credits are used up+

Each call to search_events, get_event or event_stats uses one credit; list_categories and get_coverage are free. Free has 50 credits a month and they renew every month. Usage and plans are in the console.

The answer says to wait a number of seconds+

You hit a per-minute or per-day limit. The message says how long to wait. Ask for counts with event_stats instead of paging through many search results.

A search came back empty+

An empty result is a thin stretch of the archive, not proof that nothing happened. Some countries and weeks are thinner than others. Widen the radius or the dates, or ask get_coverage which countries your account can see.

A key was shared by mistake+

Revoke it in the console, then create a new one. Keys are created and revoked in the console; apps connected with OAuth hold their own token and never see a key.

Reference

Reference: MCP tools, parameters and limits

Five tools, all read-only. Your assistant chooses the tool and fills in the parameters from a plain question; this is what it can work with.

MCP tools and their parameters

ToolWhat it does and its parametersCredit
search_eventsFind events by meaning (query), an exact name (keywords) or filters alone. Pages with next_cursor.Parameters: query, keywords, countries, address, near_lat, near_lon, radius_km, categories, date_from, date_to, min_importance, min_sources, sources, sort, limit, cursor (the next_cursor from the previous page)1
get_eventThe full record for an id: every source URL, place, category, importance, actors.Parameters: event_id1
event_statsCounts by day, week, month, category or country. Use it to compare instead of paging through results.Parameters: group_by (day, week, month, category or country), plus the place, category, date, importance and source filters of search_events1
list_categoriesThe category tree and the English names the categories argument accepts.Parameters: NoneFree
get_coverageCountries your key can see, their last 90 days of events, the earliest event, your plan's limits.Parameters: NoneFree

Three ways to narrow a search

Meaning
query: one English sentence shaped like the stored events.
A name
keywords: NATO, a company, a person, a place. Quoted phrases stay literal.
A place
countries (ISO codes such as DE), address (every word must appear), or a point: near_lat, near_lon, radius_km.

Limits and defaults

Archive starts
27 Nov 2024
Default window; set date_from to go further back
30 days
Largest radius
50 km
Date filters, inclusive
UTC days

Ranked searches return the top 200 on every plan. For longer periods, split by date; a listing with no query pages on with next_cursor. History, date range per call and page size depend on the plan (see plans).

Record fields

When
Event date; date filters take whole days.
What
One English sentence: where, who, what.
Category
Category › type › subtype. A broader name includes everything under it.
Where
Address, ISO country code, coordinates when resolved.
Sources
News URLs, domains, and how many independent sources agree.
Importance
0 to 1, so quiet events can be dropped.
Actors
Names on the full record.
Why it matched
Meaning, keyword and final score (0 to 1) on ranked search.

Example questions and the tools behind them

  • Travel and executive security

    “Our board is in Paris 12 to 14 November. Any protests, strikes or security incidents within 5 km of La Défense in the last two weeks?”

    search_events · near_lat, near_lon, radius_km

  • Logistics and supply chain

    “Port strikes or customs disruption at Rotterdam, Antwerp or Hamburg this month. Is it rising compared with last month?”

    search_events · event_stats, group_by month

  • Event security

    “Anything near the stadium in Beşiktaş in the last 7 days that matters for Saturday's match?”

    search_events · address, min_importance

  • Risk analysis and insurance

    “Weekly count of natural hazard events in Japan, Indonesia and the Philippines since January, by country.”

    A table by week and country, ready for a report.

    event_stats · group_by week, countries JP, ID, PH

Every parameter in detail is in the developer docs. Plans and prices are on the product page. Questions: info@int-tech.solutions.