How do I use OSINT MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@OSINT MCP Server search for messages about Russian tank movements in Kharkiv" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

OSINT MCP Server

by osintukraine

Overview Schema Related Servers Score Discussions

TypeScript

OSINT MCP Server

npm version License: MIT

MCP (Model Context Protocol) server for the OSINT Intelligence Platform, enabling Claude and other AI assistants to interact with your Telegram intelligence archive.

Features

This MCP server provides 65 tools organized into 14 categories for comprehensive OSINT analysis:

Message Tools (5 tools)

Tool	Description
`search_messages`	Full-text search with 15+ filters (topic, importance, language, views, etc.)
`get_message`	Get detailed message with media, AI tags, entities, locations
`get_message_album`	Get grouped media album for lightbox display
`get_message_network`	Entity relationship graph (Flowsint-compatible)
`get_message_timeline`	Temporal context - before/after, semantic, event-based

Semantic Search Tools (4 tools)

Tool	Description
`semantic_search`	AI-powered 384-dim vector search - find by meaning
`find_similar_messages`	Find content similar to a specific message
`get_tags`	Get popular AI-generated tags (keywords, topics, emotions)
`search_by_tags`	Search messages by tags with AND/OR logic

Unified Search (1 tool)

Tool	Description
`unified_search`	Search across ALL sources: messages, events, RSS, entities

Channel Tools (4 tools)

Tool	Description
`list_channels`	List monitored Telegram channels with filters
`get_channel`	Channel details, affiliation, metadata
`get_channel_stats`	Message counts, spam rate, topic distribution
`get_channel_network`	Semantic relationship graph with topic clusters

Tool	Description
`get_message_social_graph`	Complete social context: forwards, replies, comments, reactions
`get_channel_influence`	Channel-to-channel forward relationships
`get_influence_network`	Platform-wide influence network
`get_engagement_timeline`	Virality tracking over time
`get_message_comments`	Discussion thread from linked chat
`get_top_forwarded`	Viral content leaderboard
`get_top_influencers`	Top influencer profiles

Entity Tools (4 tools)

Tool	Description
`search_entities`	Search people, orgs, equipment (curated + OpenSanctions)
`get_entity`	Entity profile with aliases, metadata, linked counts
`get_entity_relationships`	Wikidata SPARQL relationships (employers, positions)
`get_entity_mentions`	Messages mentioning a specific entity

Event Tools (5 tools)

Tool	Description
`list_events`	Detected event clusters by tier (rumor→confirmed→verified)
`get_event_stats`	Event statistics by tier and type
`get_event`	Event details with channels, messages, RSS sources
`get_event_timeline`	Chronological timeline combining Telegram + RSS
`get_events_for_message`	Events linked to a specific message

Analytics Tools (7 tools)

Tool	Description
`get_timeline_stats`	Message volume over time (hour/day/week/month)
`get_topic_distribution`	Distribution across 13 topics
`get_language_distribution`	Language breakdown (uk, ru, en, etc.)
`get_channel_analytics`	Per-channel performance metrics
`get_activity_heatmap`	Daily activity for calendar visualization
`get_entity_analytics`	Most mentioned entities over time
`get_media_analytics`	Media archival stats with deduplication metrics

Map/Geo Tools (6 tools)

Tool	Description
`get_map_messages`	GeoJSON messages with server-side clustering
`get_map_clusters`	Event clusters by geographic location
`get_map_events`	Confirmed events for map display
`get_map_heatmap`	Density aggregation for heatmap
`suggest_locations`	Autocomplete from 30,000+ UA/RU locations
`reverse_geocode`	Find nearest location to coordinates

Stream Tools (1 tool)

Tool	Description
`get_unified_stream`	Combined Telegram + RSS intelligence feed

Validation Tools (2 tools)

Tool	Description
`validate_message`	Cross-reference Telegram with RSS (confirms/contradicts)
`get_message_correlations`	Find correlated RSS articles

Media Tools (1 tool)

Tool	Description
`get_media_gallery`	Browse archived media by channel, type, date

Admin Stats Tools (15 tools)

Tool	Description
`get_platform_dashboard`	Platform overview: messages, channels, entities, storage
`get_platform_stats_overview`	Comprehensive stats with service health
`get_data_quality_stats`	Enrichment coverage (translation, embeddings, geo)
`get_processing_stats`	Hourly processing metrics and latency
`get_storage_stats`	Storage breakdown by table and media type
`get_worker_stats`	Redis queue health and pending messages
`get_enrichment_tasks`	Status of 13 enrichment tasks
`get_cache_stats`	Redis cache hit rates and memory usage
`get_audit_stats`	LLM decision audit and verification rates
`get_spam_stats`	Spam classification metrics
`get_channels_admin_stats`	Channel inventory by affiliation/folder/rule
`get_entities_admin_stats`	Entity catalog stats and top mentioned
`get_rss_feeds_stats`	RSS feed health and article counts
`get_llm_prompts_stats`	LLM prompt performance metrics
`get_viral_posts`	Tracked viral posts for comment fetching

System Health Tools (9 tools)

Tool	Description
`get_system_health`	Basic API health check
`get_hardware_config`	Hardware tier detection (laptop/server/GPU)
`get_system_status`	Detailed system status
`get_metrics_overview`	Platform KPIs
`get_metrics_llm`	Ollama/LLM performance
`get_metrics_pipeline`	Real-time pipeline status
`get_metrics_services`	Per-service health
`list_llm_models`	Available LLM models (6 runtime-switchable)
`get_llm_model_health`	LLM availability check

Related MCP server: wrg-mcp-server

Installation

From npm (recommended)

npm install -g @osintukraine/mcp-server

From source

git clone https://github.com/osintukraine/osint-mcp-server.git
cd osint-mcp-server
npm install
npm run build

Configuration

Environment Variables

Variable	Description	Default
`OSINT_API_URL`	OSINT Platform API base URL	`http://localhost:8000`
JWT Authentication
`OSINT_JWT_TOKEN`	JWT token for authentication	(none)
API Key Authentication
`OSINT_API_KEY`	API key for authentication	(none)
Ory Kratos Authentication
`OSINT_ORY_USER_ID`	Ory Kratos user UUID	(none)
`OSINT_ORY_USER_EMAIL`	User email (optional)	(none)
`OSINT_ORY_USER_ROLE`	User role: authenticated, admin	`authenticated`

Authentication Priority

The MCP server uses the first available authentication method:

JWT Token - OSINT_JWT_TOKEN - Standalone JWT authentication
API Key - OSINT_API_KEY - Programmatic API access
Ory Kratos - OSINT_ORY_USER_ID - Ory identity headers

Claude Code Configuration

Add a .mcp.json file to your project root:

Using npm package:

{
  "mcpServers": {
    "osint": {
      "command": "npx",
      "args": ["@osintukraine/mcp-server"],
      "env": {
        "OSINT_API_URL": "http://localhost:8000"
      }
    }
  }
}

Using local installation:

{
  "mcpServers": {
    "osint": {
      "command": "node",
      "args": ["/path/to/osint-mcp-server/dist/index.js"],
      "env": {
        "OSINT_API_URL": "http://localhost:8000"
      }
    }
  }
}

With API Key authentication:

{
  "mcpServers": {
    "osint": {
      "command": "npx",
      "args": ["@osintukraine/mcp-server"],
      "env": {
        "OSINT_API_URL": "https://api.osint.example.com",
        "OSINT_API_KEY": "your-api-key-here"
      }
    }
  }
}

With Ory Kratos authentication:

{
  "mcpServers": {
    "osint": {
      "command": "npx",
      "args": ["@osintukraine/mcp-server"],
      "env": {
        "OSINT_API_URL": "https://api.osint.example.com",
        "OSINT_ORY_USER_ID": "your-kratos-user-uuid",
        "OSINT_ORY_USER_EMAIL": "your-email@example.com",
        "OSINT_ORY_USER_ROLE": "admin"
      }
    }
  }
}

Usage Examples

Once configured, Claude can use these tools naturally:

Message Search & Analysis

"Search for high-importance messages about Bakhmut from the last 7 days"

"Find messages similar to message #12345 and show their social graph"

"Get the entity network for message #67890"

Entity Investigation

"Search for Putin in OpenSanctions and show relationships"

"Find all messages mentioning the Wagner Group"

Event Analysis

"List confirmed events from the last 24 hours"

"Show the timeline for event #123 with both Telegram and RSS sources"

"Validate message #456 against news sources"

"Who are the top influencers in the last week?"

"Show the influence network between channels"

"Get the engagement timeline for this viral message"

Platform Monitoring

"What's the current platform health?"

"Show data quality stats - translation and embedding coverage"

"Check the worker queue status"

Geographic Analysis

"Get geolocated messages in the Kharkiv region"

"Show the event heatmap for the last 48 hours"

Development

# Watch mode (auto-rebuild on changes)
npm run dev

# Type checking
npm run typecheck

# Test with MCP Inspector
npm run inspector

Architecture

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  Claude Code    │────▶│  MCP Server      │────▶│  OSINT API      │
│  (AI Assistant) │     │  (65 tools)      │     │  (FastAPI)      │
└─────────────────┘     └──────────────────┘     └─────────────────┘
         │                       │                        │
         │  stdio transport      │  HTTP/JSON             │
         │                       │                        │
    ┌────┴────┐            ┌─────┴─────┐           ┌──────┴──────┐
    │ Request │            │ API Client│           │ PostgreSQL  │
    │ Handler │            │ (fetch)   │           │ + pgvector  │
    └─────────┘            └───────────┘           └─────────────┘

License

MIT - see LICENSE

Contributing

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

OSINT Intelligence Platform - Main platform
Model Context Protocol - MCP specification
MCP SDK - Official MCP SDK

Install Server

license - not found

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

Straight Connect
Communication App Automation
AI-Guru
F
license
-
quality
D
maintenance
An MCP server for communication service connectors that currently provides multi-account Telegram integration with granular tool access and security controls. It allows AI models to manage messages, chats, and media across various accounts through a flexible, extensible routing architecture.
Updated 5 months ago (2026-03-13 12:47 UTC)
1
wrg-mcp-server
Security Penetration Testing Code Analysis
WRG-11
A
license
-
quality
A
maintenance
An MCP server that exposes a 60+ tool security and threat-intel stack to AI agents, enabling secret scanning, Sigma rule generation, ransomware lookup, OSINT, and deep research.
Updated 2 months ago (2026-06-10 18:22 UTC)
1
MIT
OSINT Tools MCP Server
Open Data Research & Data Security
frishtik
A
license
-
quality
D
maintenance
A comprehensive MCP server that exposes multiple OSINT tools to AI assistants like Claude, enabling sophisticated reconnaissance and information gathering tasks using industry-standard OSINT tools.
Updated a year ago (2025-08-07 13:52 UTC)
229
MIT
omega-mcp-server
Penetration Testing Research & Data
Ekoelogan
A
license
-
quality
D
maintenance
MCP server that exposes 108+ omega-cli OSINT tools for reconnaissance, web analysis, threat intelligence, and reporting, enabling AI assistants to perform comprehensive open-source intelligence tasks.
Updated 4 months ago (2026-04-01 03:17 UTC)
MIT

View all related MCP servers

Related MCP Connectors

gainium-mcp
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
mcp
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
mcp-knowledge
100+ MCP tools for AI agents: content metadata, trade intelligence, business-expertise analysis.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/osintukraine/osint-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

OSINT MCP Server

Features

Message Tools (5 tools)

Semantic Search Tools (4 tools)

Unified Search (1 tool)

Channel Tools (4 tools)

Social Graph Tools (7 tools)

Entity Tools (4 tools)

Event Tools (5 tools)

Analytics Tools (7 tools)

Map/Geo Tools (6 tools)

Stream Tools (1 tool)

Validation Tools (2 tools)

Media Tools (1 tool)

Admin Stats Tools (15 tools)

System Health Tools (9 tools)

Installation

From npm (recommended)

From source

Configuration

Environment Variables

Authentication Priority

Claude Code Configuration

Usage Examples

Message Search & Analysis

Entity Investigation

Event Analysis

Social Graph & Influence

Platform Monitoring

Geographic Analysis

Development

Architecture

License

Contributing

Related Projects

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Straight Connect

wrg-mcp-server

OSINT Tools MCP Server

omega-mcp-server

Related MCP Connectors

Latest Blog Posts

MCP directory API