Metadata-Version: 2.5
Name: instagram-data-mcp
Version: 0.1.5
Summary: MCP server for public Instagram data: profiles, posts, reels, stories, highlights, comments, hashtags and more.
Project-URL: Homepage, https://fastsocial.co/instagram-api
Project-URL: Documentation, https://fastsocial.co/instagram-api/docs
Project-URL: Repository, https://github.com/FastSocialCo/instagram-data-mcp-python
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agents,claude,instagram,instagram-api,mcp,model-context-protocol,scraper
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.10
Requires-Dist: anyio>=4
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=2.2
Description-Content-Type: text/markdown

# instagram-data-mcp (local stdio package)

<!-- mcp-name: io.github.FastSocialCo/instagram-data-mcp -->

A small local MCP server for public Instagram data, published on PyPI as `instagram-data-mcp`.
It gives Claude, Cursor and any other MCP client 27 read-only tools: profiles, posts, reels,
stories, highlights, comments, likers, followers, hashtags, places, audio and search.

Most people don't need this package. The same tools are available from the remote server at
`https://data.fastsocial.co/mcp`, with sign-in in the browser and nothing to install. Setup for
that is in [FastSocialCo/instagram-data-mcp](https://github.com/FastSocialCo/instagram-data-mcp).
Use this package if your client only runs local (stdio) servers.

## Run it

Get a key at https://fastsocial.co/instagram-api (there is a free plan), then:

```json
{
  "mcpServers": {
    "instagram-data": {
      "command": "uvx",
      "args": ["instagram-data-mcp"],
      "env": { "IG_DATA_API_KEY": "your_key" }
    }
  }
}
```

No `uvx`? `pip install instagram-data-mcp` and use `"command": "instagram-data-mcp"` instead.

## What it does and what it sends

The whole server is [`server.py`](src/instagram_data_mcp/server.py), about 150 lines. It reads the
bundled [`openapi.json`](src/instagram_data_mcp/openapi.json) (the public spec of the Instagram
Data API) and turns each `GET` endpoint into one tool.

When a tool is called, it makes one HTTPS `GET` request to `https://data.fastsocial.co/v1/<endpoint>`
with the tool's arguments as query parameters, your key in the `X-API-Key` header and
`instagram-data-mcp` as the user agent. It returns the JSON response as is. That is the only
network request it makes.

- Every tool reads. Each one is marked `readOnlyHint: true`. None can log in to Instagram, post,
  follow, like or message.
- It writes no files and stores nothing. Your key stays in your client's config and is only ever
  sent in that header.
- No install scripts, no telemetry.

Privacy policy: https://fastsocial.co/privacy · Terms: https://fastsocial.co/terms

## Settings

| Env var | Default | |
|---|---|---|
| `IG_DATA_API_KEY` | none | Required |
| `IG_DATA_API_BASE` | `https://data.fastsocial.co` | |
| `IG_DATA_API_TIMEOUT` | `60` | Seconds |

## Tools

The tool list and what each one costs in credits are in the
[plugin README](https://github.com/FastSocialCo/instagram-data-mcp#the-27-tools) and the
[API docs](https://fastsocial.co/instagram-api/docs).

## Security

Report a vulnerability to contact@fastsocial.co. See
[SECURITY.md](https://github.com/FastSocialCo/instagram-data-mcp/blob/main/SECURITY.md).

## License

MIT
