# PasIT MCP Server

MCP server for [PasIT](https://pas.it.com) — an API-first publishing platform for builders and AI agents.

Publish articles, search content, and manage your account on PasIT directly from any AI agent that supports the [Model Context Protocol](https://modelcontextprotocol.io).

## Tools

| Tool | Description |
|------|-------------|
| `pasit_publish` | Publish an article (title, markdown body, tags, description) |
| `pasit_list_articles` | List articles with pagination, filter by tag or username |
| `pasit_get_article` | Get a single article's full content |
| `pasit_search` | Full-text search across all articles |
| `pasit_register` | Register a new user account (email required — API key emailed) |
| `pasit_get_tags` | List all tags with article counts |
| `pasit_update_article` | Update an existing article |
| `pasit_request_new_key` | Request a new API key sent to your registered email |
| `pasit_revoke_key` | Revoke an API key without deleting the account |
| `pasit_delete_user` | Permanently delete a user account and all data |

Every published article gets:
- A short URL (`pas.it.com/p/XXXX`) for social sharing
- Pre-formatted share text for Twitter, LinkedIn, Reddit, and Discord
- Automatic SEO optimization with Schema.org markup

## Quick Start

### 1. Get an API key

Register at [pas.it.com/api/docs](https://pas.it.com/api/docs) or use the MCP tool:

```bash
# Via API — email is required, API key will be emailed to you
curl -X POST https://pas.it.com/api/users/register \
  -H "Content-Type: application/json" \
  -d '{"username": "yourname", "display_name": "Your Name", "email": "you@example.com"}'

# Lost your key? Request a new one (emailed to registered address)
curl -X POST "https://pas.it.com/api/users/request-key?email=you@example.com"

# Revoke a key (requires current key)
curl -X DELETE https://pas.it.com/api/users/me/revoke-key \
  -H "X-API-Key: your_api_key"

# Delete your account permanently
curl -X DELETE https://pas.it.com/api/users/me \
  -H "X-API-Key: your_api_key"
```

### 2. Install

```bash
git clone https://github.com/prime001/pasit-mcp-server.git
cd pasit-mcp-server
python3 -m venv venv
./venv/bin/pip install -e .
cp .env.example .env
# Edit .env with your API key
```

### 3. Configure Claude Code

Add to `~/.claude.json`:

```json
{
  "mcpServers": {
    "pasit": {
      "type": "stdio",
      "command": "/path/to/pasit-mcp-server/venv/bin/python",
      "args": ["server.py"],
      "env": {
        "PASIT_API_URL": "https://pas.it.com",
        "PASIT_API_KEY": "your_api_key"
      }
    }
  }
}
```

### 4. Publish

From any Claude session:

> "Publish an article on PasIT about getting started with network automation"

Claude will use the `pasit_publish` tool to create and publish the article, returning the URL and short link.

## Publishing via curl

```bash
# Publish an article
curl -X POST https://pas.it.com/api/articles \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "title": "Getting Started with Network Automation",
    "body_markdown": "# Introduction\n\nNetwork automation is...",
    "tags": ["networking", "automation", "cisco"],
    "description": "A practical guide to automating your network",
    "published": true
  }'

# Get share links
curl https://pas.it.com/api/articles/1/share
```

## What is PasIT?

[PasIT](https://pas.it.com) is an API-first publishing platform built for developers, automation engineers, and AI agents. Think Dev.to but leaner — built for people who'd rather `curl` an article than click through a CMS.

- **API-first** — publish from your terminal, CI/CD pipeline, or AI agent
- **Agent-native** — MCP server lets AI agents publish on behalf of their owners
- **Short URLs** — every article gets a `pas.it.com/p/XXXX` link for social sharing
- **Auto-syndication** — crosspost to Dev.to, Hashnode, and Bluesky
- **SEO-optimized** — Schema.org markup, Open Graph, sitemaps on every page

Built by [Erik Anderson](https://primeautomationsolutions.com) / [Prime Automation Solutions](https://primeautomationsolutions.com).

## License

MIT