Metadata-Version: 2.4
Name: flexorch-mcp
Version: 0.1.1
Summary: MCP server for FlexOrch — SDK for machines
Project-URL: Homepage, https://flexorch.com
Project-URL: Documentation, https://docs.flexorch.com
Project-URL: Repository, https://github.com/flexorch/flexorch-mcp
Project-URL: Changelog, https://github.com/flexorch/flexorch-mcp/blob/main/CHANGELOG.md
Author-email: Flexorch Technology <founder@flexorch.com>
License: MIT License
        
        Copyright (c) 2026 flexorch
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: agents,document-processing,flexorch,llm,mcp,pii
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp<2.0,>=1.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Description-Content-Type: text/markdown

# flexorch-mcp

**MCP server for FlexOrch — SDK for machines.**

Connect Claude and other MCP-compatible agents to the [FlexOrch](https://flexorch.com) document intelligence pipeline. Process documents, extract structured data, detect PII, and export LLM-ready datasets — all through natural language tool calls.

---

## What this is

`flexorch-mcp` is a thin proxy that exposes the FlexOrch API as MCP tools. All processing happens on FlexOrch's managed infrastructure. A FlexOrch account and API key are required.

**For humans writing code:** use [flexorch-sdk](https://github.com/flexorch/flexorch-sdk) (Python) or [flexorch-sdk-js](https://github.com/flexorch/flexorch-sdk-js) (TypeScript).  
**For agents:** use this package.

---

## Tools

| Tool | Description |
|------|-------------|
| `process_document` | Upload and process a document (PDF, DOCX, TXT, XLSX, HTML, XML, EML, JPG, PNG, TIFF) |
| `get_job_status` | Poll a processing job until completed or failed |
| `get_extraction_result` | Get structured extracted fields from a completed job |
| `build_dataset` | Build a structured dataset from a completed execution |
| `search_documents` | Semantic search across indexed datasets (Pro+) |
| `export_dataset` | Export a dataset as JSONL, CSV, JSON, XML, MD, or RAG (LangChain/LlamaIndex chunks) |

---

## Installation

```bash
pip install flexorch-mcp
```

Requires Python 3.10+.

---

## Configuration

### Claude Desktop

Add to `~/.claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "flexorch": {
      "command": "flexorch-mcp",
      "env": {
        "FLEXORCH_API_KEY": "dfx_your_key_here"
      }
    }
  }
}
```

### Cursor

Add to your Cursor MCP config:

```json
{
  "flexorch": {
    "command": "flexorch-mcp",
    "env": {
      "FLEXORCH_API_KEY": "dfx_your_key_here"
    }
  }
}
```

Get your API key from [app.flexorch.com/settings](https://app.flexorch.com/settings).

---

## Verify connection

```bash
flexorch-mcp --check
# → FlexOrch API key: dfx_xxx*** ✓
# → Connection: OK (api.flexorch.com)
# → Plan: Starter (1,200 credits/mo)
# → Tools: 6 registered
```

---

## Example agent workflow

```
User: "Process this invoice and export it as JSONL for fine-tuning."

Agent:
  1. process_document(file_url="https://...")   → job_id: 1234
  2. get_job_status(1234)                        → completed, execution_id: 567
  3. get_extraction_result(567)                  → vendor, total, date, PII masked
  4. build_dataset(execution_id=567)             → job_id: 1235
  5. get_job_status(1235)                        → completed, dataset_id: 89
  6. export_dataset(89, format="jsonl")          → inline JSONL content
```

---

## Plan limits

All FlexOrch plan limits apply to MCP tool calls. Credits are consumed per document processed.

| Plan | Credits/mo | Semantic search |
|------|-----------|----------------|
| Trial | 1,200 (30 days) | — |
| Starter | 1,200 | — |
| Pro | 6,000 | ✓ |
| Enterprise | Custom | ✓ |

---

## Security

- API key is read from the `FLEXORCH_API_KEY` environment variable — never passed as a tool argument
- No data is stored or cached by this server — stateless proxy
- PII masking is applied by FlexOrch's pipeline before results are returned
- All communication with `api.flexorch.com` uses HTTPS

---

## Related

- [flexorch-audit](https://github.com/flexorch/flexorch-audit) — Standalone PII detection and document quality scoring (no account required)
- [flexorch-sdk](https://github.com/flexorch/flexorch-sdk) — Python SDK for developers
- [flexorch-sdk-js](https://github.com/flexorch/flexorch-sdk-js) — TypeScript SDK for developers
- [docs.flexorch.com](https://docs.flexorch.com) — Full documentation

---

## License

MIT — see [LICENSE](LICENSE).
