Heisenberg FastMCP Agent
A Model Context Protocol server that provides tools to interact with Heisenberg services for real-time data analysis, social media monitoring, and specialized AI agent interactions.
Available Tools
Core Agent Tools
-
list_of_agents- Retrieves all available AI agents for specialized data analysis- When to use: Automatically called for any request involving current events, real-time data, social media analysis, or domain-specific information
- Returns: List of available agents with their IDs and descriptions
-
inference_from_prompt- Queries specialized agents for current data or domain-specific analysis- Required arguments:
agent_id(integer): The ID of the agent (obtained fromlist_of_agents)prompt(string): The text prompt for analysis
- Required arguments:
Twitter/X Trend Analysis Tools
-
twitter_trends_options- Get available parameters for Twitter trend analysis- When to use: MUST be called first before using
twitter_trends() - Returns: Available verticals (categories) and durations (time periods)
- When to use: MUST be called first before using
-
twitter_trends- Analyze Twitter/X trends for specific categories and time periods- Required arguments:
vertical(string): Category from options (e.g., "politics", "tech", "sports")duration(string): Time period from options (e.g., "1h", "24h", "7d")
- Required arguments:
Installation
Using uv (recommended)
uvx heisenberg-mcp-server
Using PIP
pip install heisenberg-mcp-server
Run as a script:
python -m heisenberg
Configuration
Configure for Claude.app
Using uvx
{
"mcpServers": {
"heisenberg": {
"command": "uvx",
"args": [
"heisenberg-mcp-server"
],
"env": {
"HEISENBERG_TOKEN": "*****",
"HEISENBERG_KEY": "*****"
},
"timeout": 60000
}
}
}
Using pip installation
{
"mcpServers": {
"heisenberg": {
"command": "python",
"args": [
"-m",
"heisenberg"
],
"env": {
"HEISENBERG_TOKEN": "*****",
"HEISENBERG_KEY": "*****"
},
"timeout": 60000
}
}
}
Example Interactions
1. Political Analysis on X/Twitter
{
"agent_id": 1,
"prompt": "What are the latest political conversations on X about the upcoming elections?"
}
Response:
[
{
"tweet_text": "Special election results hint at what's next for Congress' power balance",
"tweet_time": "2025-04-02T11:44:41Z",
"tweet_url": "https://x.com/FoxNews/status/1907398780615373105"
}
]
2. Twitter Trends Analysis
First, get available options:
twitter_trends_options()
# Returns: {"verticals": ["AI", "Crypto", "Football"], "durations": ["last_3_day", "last_day", "last_week"]}
Then analyze trends:
twitter_trends(vertical="Crypto", duration="last_day")
# Returns trending crypto topics from the last day
Workflow Summary
-
For general current data needs:
list_of_agents()→ Select relevant agent →inference_from_prompt()
-
For Twitter/X specific trends:
twitter_trends_options()→ Select parameters →twitter_trends()
Use Cases
- Real-time Social Media Monitoring: Track conversations and trends across platforms
- Current Events Analysis: Get up-to-date information on news and world events
- Market Intelligence: Monitor financial trends and market sentiment
- Technology Trends: Track emerging tech topics and developer discussions
- Entertainment & Sports: Follow trending topics and cultural phenomena
Requirements
- Valid Heisenberg API tokens (HEISENBERG_TOKEN and HEISENBERG_KEY)
- Network access to Heisenberg services
Metadata
Release files for heisenberg-mcp-server 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| heisenberg_mcp_server-0.3.0.tar.gz | 6.2 kB | Without provenance | Details for heisenberg_mcp_server-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| heisenberg_mcp_server-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for heisenberg_mcp_server-0.3.0-py3-none-any.whl |
Total release size: 13.7 kB
Release files / heisenberg_mcp_server-0.3.0.tar.gz
| Download URL | heisenberg_mcp_server-0.3.0.tar.gz |
|---|---|
| Size | 6.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ea443877ec1c4a67924cbbb84985ee21e464086ced597a695bc143a947785c3b
|
|
BLAKE2b-256 checksum How to use checksums |
f3903a944431d6721b84ac885065530723233fe9978a2126cabe2e9635e12383
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.12
|
Release files / heisenberg_mcp_server-0.3.0-py3-none-any.whl
| Download URL | heisenberg_mcp_server-0.3.0-py3-none-any.whl |
|---|---|
| Size | 7.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cab6d3fc845dff0a1c79baf608e57fae1b4afced148f4f977251118795772dc2
|
|
BLAKE2b-256 checksum How to use checksums |
25b1721816758fac171d8ed79dae9a86fc718a018b05a153064d998cfb86b164
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.12
|
Security for heisenberg-mcp-server 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.