Metadata-Version: 2.4
Name: diaspora-mcp
Version: 0.1.5
Summary: Kenya diaspora services via MCP — immigration, dual citizenship, diaspora taxes, homeland investment, community. 6 tools.
License: MIT
Project-URL: Homepage, https://github.com/gabrielmahia/diaspora-mcp
Project-URL: Documentation, https://github.com/gabrielmahia/nairobi-stack
Project-URL: MCP Registry, https://registry.modelcontextprotocol.io
Project-URL: Datasets, https://huggingface.co/gmahia
Project-URL: Evaluation, https://github.com/gabrielmahia/kipimo
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=0.9
Dynamic: license-file

# diaspora-mcp
<!-- mcp-name: io.github.gabrielmahia/diaspora-mcp -->

## Why This Exists

Kenyans abroad navigate dual citizenship, diaspora taxation, property purchase and document verification across two legal systems at once, usually with advice that is out of date or second-hand. The cost of getting it wrong is measured in years, not shillings.

## Install

```bash
pip install diaspora-mcp
```

## Tools (6)

- **`dual_citizenship_guide`** —   
  <sub>args: current_citizenship</sub>
- **`diaspora_tax_guide`** —   
  <sub>args: residence_country</sub>
- **`kenya_homeland_investment`** —   
  <sub>args: budget_usd</sub>
- **`diaspora_verification`** —   
  <sub>args: document_type</sub>
- **`diaspora_community_guide`** —   
  <sub>args: country</sub>
- **`immigration_status_guide`** —   
  <sub>args: country, status</sub>

## Example

```python
from diaspora_mcp.server import dual_citizenship_guide

result = dual_citizenship_guide()
# eligibility, process, documents, common pitfalls
```

## Claude Desktop Integration

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "diaspora-mcp": {
      "command": "python",
      "args": ["-m", "diaspora_mcp.server"]
    }
  }
}
```

## Data & Disclaimers

Immigration, tax and property rules change and interact with the law of your country of residence. This is orientation, not legal or tax advice — confirm with an advocate and a qualified tax adviser.

Every tool response carries a `source` field. Responses labelled `DEMO` are
illustrative reference data, not a live feed — verify against the authority
named in the response before acting on it.

## Part of the East Africa Coordination Stack

This MCP server is part of the Kenya coordination infrastructure.
Connect it to [`africa-coord-bus`](https://github.com/gabrielmahia/africa-coord-bus) —
the coordination event bus that routes signals between domains automatically.

```bash
pip install africa-coord-bus
```

All servers: [pypi.org/user/gmahia](https://pypi.org/user/gmahia/)
Live demo: [coord-cascade-demo](https://github.com/gabrielmahia/coord-cascade-demo)

## IP & Collaboration

MIT licensed. Feedback via GitHub Issues only — pull requests are not accepted. Demo data is labeled DEMO and is not suitable for operational decisions. Full policy: [docs/architecture/IP_POLICY.md](docs/architecture/IP_POLICY.md). Security reports: see [SECURITY.md](SECURITY.md).

<!-- interconnect:v1 -->
## Part of the East Africa coordination stack

- **Install & run:** `pip install reli-cli && reli list` — the MCP servers on the [official MCP Registry](https://registry.modelcontextprotocol.io) under `io.github.gabrielmahia`
- **Evaluate any model on Swahili agent tasks:** [kipimo](https://github.com/gabrielmahia/kipimo) · [dataset](https://huggingface.co/datasets/gmahia/kipimo) · [leaderboard](https://huggingface.co/spaces/gmahia/kipimo-leaderboard)
- **Coordinate across servers:** [africa-coord-bus](https://pypi.org/project/africa-coord-bus/) — offline-first event bus with a built-in Kenya routing table
- **Datasets:** [huggingface.co/gmahia](https://huggingface.co/gmahia) · **Docs hub:** [nairobi-stack](https://github.com/gabrielmahia/nairobi-stack)

Model-agnostic by design: closed APIs, open-weight models, and small distilled models are all first-class citizens.
<!-- /interconnect:v1 -->
