niwashi-mcp

MCP server for Cisco ACI (APIC). It reads the fabric's own object model rather than a fixed list of endpoints, so an LLM agent can navigate all 15,452 ACI classes through five generic tools — with no hardcoded class knowledge.

uvx niwashi-mcp

No repository to clone, no schema bundle to download. The object model ships inside the niwaki dependency as an embedded catalogue.

Configure

Three variables, in a .env file or the environment:

APIC_HOST=10.0.0.1
APIC_USER=admin
APIC_PASSWORD=…

Optional: APIC_VERIFY_SSL (default false), MCP_PORT (default 8000), MCP_API_KEYS (comma-separated bearer tokens — unset means no authentication, and the server says so loudly at startup), NIWASHI_MCP_ENV_FILE (explicit path to the .env).

The five tools

Tool Purpose
search_classes find the exact ACI class name from a keyword
get_schema identifiers, containment, relations, properties of a class
query filtered class query against the APIC
get_by_dn fetch one object directly by DN
count count objects without transferring them

The intended order is search_classes → get_schema → query. Skipping the first two returns empty results silently, because the APIC answers 200 OK with an empty list for an unknown class or attribute — it does not error.

Documentation

Full documentation, architecture notes and deployment guides: https://github.com/k3l0-dev/niwashi-mcp

The repository also carries mcp/client/SKILL.md — the operating guide to give an LLM client alongside the server. It teaches the ACI object model, the mandatory tool order, and how to read a relation without concluding wrongly.

Requirements

Python ≥ 3.12. A reachable APIC and a read-only service account.

Licence

PolyForm Noncommercial 1.0.0 — free for personal, research and noncommercial use. Commercial deployment or integration requires a commercial licence: monark.aiops@pm.me.

Cisco, Cisco ACI and APIC are trademarks of Cisco Systems, Inc. niwashi-mcp is an independent project, not affiliated with or endorsed by Cisco Systems, Inc.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for k3l0-dev from gravatar.com k3l0-dev

Credits

Author/Maintainer: Khalid El-Ouiali

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Other/Proprietary License (PolyForm-Noncommercial-1.0.0)

Requires

Python >=3.12

Tags

aci apic cisco llm mcp network-automation niwaki

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

niwashi_mcp-2.1.1.tar.gz (472.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

niwashi_mcp-2.1.1-py3-none-any.whl (60.6 kB view details)

Uploaded Python 3

File details

Details for the file niwashi_mcp-2.1.1.tar.gz.

File metadata

  • Download URL: niwashi_mcp-2.1.1.tar.gz
  • Upload date:
  • Size: 472.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for niwashi_mcp-2.1.1.tar.gz
Algorithm Hash digest
SHA256 18de94d7972bc8d5c633a03850b584d98e74d10eb95f70a5083500ce4808f19e
MD5 5f711b7bdadcb4333770f7ad8b922665
BLAKE2b-256 0c001ee1c12919359a3a872c86ab2d0d3d42a2bfe586d5a61ec5927978d2a457

See more details on using hashes here.

Provenance

The following attestation bundles were made for niwashi_mcp-2.1.1.tar.gz:

Publisher: release.yml on k3l0-dev/niwashi-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file niwashi_mcp-2.1.1-py3-none-any.whl.

File metadata

  • Download URL: niwashi_mcp-2.1.1-py3-none-any.whl
  • Upload date:
  • Size: 60.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for niwashi_mcp-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f2665092bed2982ef02dce0dd2ece522a3a87bc2d78a105312c85bb07a064ac5
MD5 f19caa0a937d1b42a097b835eef7e953
BLAKE2b-256 decd29147485163ad95b9a723fcb2cc96fa56432ea14945c5a321dee025e97c0

See more details on using hashes here.

Provenance

The following attestation bundles were made for niwashi_mcp-2.1.1-py3-none-any.whl:

Publisher: release.yml on k3l0-dev/niwashi-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page